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INTRODUCTION 


Welcome to RealSystem G2, the most sophisticated system for 
streaming multimedia files across a network. This manual will help 
you produce your multimedia presentation, whether you simply 
want to stream a video from your home page or create a multimedia 


extravaganza with video, audio, animation, images, and text. 


Note 
The HTML version of this manual, available at 
http://service.real.com/help/library/encoders.html, 
contains multimedia examples you can view with 
RealPlayer G2. 


How this Manual is Organized 


This manual tells how to assemble a RealSystem G2 presentation. Although it 
gives tips on producing great content, the more you know about producing 
audio, video, and graphics in general, the faster you’ll put together a great 
streaming presentation. If you know the basics of HTML, you'll find it easy to 
pick up SMIL, the language used to assemble RealSystem G2 presentations. 


Additional Information 
This manual does not explain how to use RealSystem 
tools like RealProducer. For specific information about 
running a tool, refer to the tool’s manual or online help. 


Chapter 1: What’s New in RealSystem G2? 
If you’re familiar with previous versions of RealSystem, this chapter will give 
you a quick update on the many changes in RealSystem G2. 


Chapter 2: Creating RealSystem Presentations 
If you are new to streaming media, this chapter walks you through the steps 
you take to put together a RealSystem G2 presentation. 
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Chapter 3: Targeting Bandwidth 
This chapter explains how to target bandwidth connections, an important 
step for creating a streaming media presentation. 


Chapter 4: Producing Audio 
This chapter gives you pointers on capturing and digitizing high-quality 
audio. It then gives you the background you need to encode a RealAudio file. 


Chapter 5: Producing Video 
Read this chapter to learn how to capture high-quality video and optimize it 
for conversion to RealVideo. 


Chapter 6: Producing Animation 

Macromedia’s Flash animation paired with a RealAudio soundtrack produces 
dazzling RealFlash presentations. This chapter tells you how to create 
RealFlash content. 


Chapter 7: Assembling a Presentation with SMIL 

After you create your multimedia clips, you write a SMIL file that pulls the 
presentation together. This chapter explains how to use SMIL to specify when 
and how each part of your presentation plays. 


Chapter 8: Playing Clips in a Web Page 
If you want to integrate your presentation seamlessly into your Web page, 
follow the instructions in this chapter. 


Chapter 9: Inserting Ads in a Presentation 
This chapter explains how to use SMIL to insert ads into your streaming 
presentation. 


Chapter 10: Delivering a Presentation 

This chapter provides step-by-step instructions for moving your presentation 
files to RealServer and linking your Web page to them. It also explains how to 
use a Web server to deliver simple presentations. 


Chapter 11: Broadcasting a Presentation 
Refer to this chapter if you plan to broadcast an audio or video event. 


Appendix A: Quick Steps for Streaming Clips 
If you are new to RealSystem streaming, this appendix helps you get started 
quickly by listing the basic steps you take to create simple presentations. 
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Appendix B: Advanced Production Techniques 
For advanced users, this appendix conveys useful production techniques that 
help you get the most out of RealSystem G2. 


Appendix C: SMIL Quick Reference 
Once you understand SMIL as described in Chapter 7, use Appendix C asa 
reference when writing SMIL files. 


Appendix D: File Type Reference 
This appendix provides a quick reference for common file types used in 
RealSystem G2 streaming. 


Appendix E: SMIL Language Codes 
If you create clips in different languages, you can use these codes in the SMIL 
file to indicate language choices. 


Conventions in this Manual 


The following table explains the conventions used in this manual. 


Notational Conventions 


Convention Meaning 


variables Italicized text represents variables. Substitute values 


appropriate for your situation. 
Pprop y' 


emphasis Bolded text is used for emphasis. 


[options] Square brackets indicate optional values you may or may 


not need to use. 


choice 1|choice 2 | Vertical lines separate values you can choose between. 


Ellipses indicate nonessential information omitted from 
the example. 


Additional RealSystem G2 Resources 


In addition to this manual, you may need the following RealNetworks 
resources, available at http://service.real.com/help/library/index.html: 


+ RealText Authoring Guide 


This manual explains how to create streaming text. You can use RealText, 
for example, to create a stock ticker or provide video subtitles. 
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+ RealPix Authoring Guide 


With RealPix you can create streaming slideshows of still images. RealPix 
Authoring Guide explains how to put a RealPix presentation together with 
special effects such as fades and zooms. 


+ RealServer Administration Guide 


The basic reference for the RealServer administrator, this manual explains 
how to set up, configure, and run RealServer to stream multimedia. You 
need this manual only if you are running RealServer yourself. 


- Embedded RealPlayer Extended Functionality Guide 


This guide supplements RealSystem G2 Production Guide. It explains how to 
use JavaScript or VBScript to control RealPlayer functions for a 
presentation embedded in a Web page. 


+ RealSystem G2 Authoring Kit 


The Authoring Kit contains production tools, utilities, and manuals in a 
single, convenient bundle. It is available through registration at 


http://www.real.com/products/tools/authkit/index.html. 
- RealSystem G2 Software Development Kit (SDK) 


The RealSystem G2 SDK lets you integrate applications with RealSystem 
or create new plug-ins for RealServer or RealPlayer. Knowledge of 
programming is required to use the SDK. Register for and download the 
SDK from http://www.real.com/devzone. 


Technical Support 
For technical support with RealSystem G2, please fill out the form at: 
- http://service.real.com/contact/email.htm 


The information you provide in this form will help technical support 
personnel to give you a prompt response. For general information about 
RealNetworks' technical support, visit: 


- http://service.real.com/help/call.html 
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The open, end-to-end architecture of RealSystem™ G2 changes the 
nature of streaming multimedia, giving you more possibilities for 
creating Web-based multimedia than before. If you’re familiar with 
past versions of RealSystem, this chapter gives you a quick look at 
the many changes in RealSystem G2. 


New Streaming Possibilities 


Text and Still Images Now Stream 

RealText™ and RealPix™ let you stream text and create streaming slideshows 
that use special effects such as fades and zooms. In RealSystem G2, they join 
RealAudio®, RealVideo®, and RealFlash™ as standard RealSystem clip types. 
In addition, RealPlayer® G2 and RealPlayer Plus™ G2 can display JPEG and 
GIF images. 


Additional Information 
See “Choosing Media to Stream” on page 11. 


Popular File Formats Stream Natively 

With RealSystem, you can now stream many popular audio and video formats. 
Stream WAV files without conversion to RealAudio, for example, AVI without 
conversion to RealVideo. Note, however, that these file formats typically do 
not stream over networks as easily and robustly as RealAudio and RealVideo. 


Additional Information 
See “Choosing Media to Stream” on page 11. 


Open Plug-In Architecture Streams New File Types 

RealSystem’s open architecture lets RealNetworks’ development partners 
create plug-ins to stream virtually any file type. Automatic download of plug- 
ins ensures that RealPlayer G2 users can play new RealSystem streaming file 
types as soon as they are introduced. 
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Additional Information 
Visit http://www.real.com/devzone/realdevelopers/ 
for information on joining the RealNetworks developer 
program. 


Advancements in RealAudio and RealVideo 


SureStream™ Technology Encodes Single Clips for Multiple Bandwidths 

The new SureStream technology available exclusively in RealSystem G2 lets 
you encode a single RealAudio or RealVideo clip for up to six separate 
bandwidths. All Web page visitors click the same link to play the clip, but their 
RealPlayers receive different encodings appropriate for their various 
connection speeds. 


Additional Information 
See “Using SureStream Clips for Multiple Bandwidths” 
on page 35 for an overview of SureStream. 


New RealAudio Codecs Provide Superior Sound Quality 

RealSystem G2 introduces a new family of RealAudio codecs that provides fast 
encoding, superior sound, and the ability to encode a single clip for delivery at 
different bit rates using SureStream technology. 


Additional Information 
“Choosing RealAudio Codecs” on page 45 lists the new 
codecs. 


Multiple Audio Streams Play through the Same Codec 

RealPlayer G2 removes the restriction that two RealAudio streams played 
simultaneously must be encoded with different codecs. RealPlayer G2 can now 
play multiple streams that use the same codec. 


New RealVideo Codec Provides Fast Encoding for Multiple Bandwidth Clips 
RealSystem G2 introduces a new RealVideo codec that provides faster 
encoding and lets you use SureStream technology to encode a single 
RealVideo clip for up to six different bandwidths. 


Additional Information 
See “Choosing RealVideo Codecs” on page 57 for more 
information. 
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Easier Presentation Assembly 


SMIL Files Coordinate Presentations 

For presentations that include more than one clip, you create a SMIL file to 
specify how and when each clip plays. SMIL, which stands for Synchronized 
Multimedia Integration Language, is a standardized language that uses a 
simple mark-up similar to HTML to coordinate a streaming presentation. 


Additional Information 
For a look at SMIL features, see “Writing a SMIL File” 
on page 18. Refer to Chapter 7 beginning on page 75 for 
instructions on using SMIL. 


Bandwidth Negotiation through Multiply-Encoded Clips or SMIL 

RealSystem G2 introduces simpler methods for supporting multiple 
bandwidth connections. As described previously, the new SureStream 
technology allows you to encode a single RealAudio or RealVideo clip for 
multiple connection speeds. Or you can let RealPlayer choose between 
different versions of a presentation based on bandwidth parameters in the 
SMIL file. Either way, you need just one link on your Web page, and your 
encoded clips do not need to conform to any naming conventions. 


Additional Information 
See “Supporting Multiple Bandwidth Connections” on 
page 34 for an overview. 


RealPlayer Launched Automatically 

The Ramgen feature of RealServer™ G2 can launch RealPlayer automatically. 
This means you do not need to create a Ram file (extension .ram or .rpm) 
manually. In your Web page, you link to a SMIL file or media clip, including in 
the URL a Ramgen parameter that causes the Web browser to launch 
RealPlayer and give it the SMIL file or clip. 


Additional Information 


See “Linking your Web Page to RealServer” on page 147. 
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Enhanced Protocol Support 


RTSP Protocol Now Used 

Because it still supports the PNA protocol, RealServer G2 is backwards 
compatible with RealSystem 3.0 through 5.0. But it introduces as its primary 
protocol the RealTime Streaming Protocol (RTSP), an open, standards-based 
protocol for multimedia streaming. Because of this, URLs that point to media 
clips on RealServer G2 now begin with rtsp://. 


RealSystem Interoperates with RTP-Based Servers and Clients 

When communicating with RealPlayer G2, RealServer G2 uses RealTime 
Streaming Protocol (RTSP) as its control protocol and RealNetworks’ 
proprietary RDT as its packet protocol. But because RealSystem G2 also 
supports international standards for streaming media, RealServer and 
RealPlayer interoperate with RTP-based media servers and clients. The 
following table lists the protocols used with different mixes of servers and 


clients. 
RealSystem Protocols 
Server Client Control Protocol Packet Protocol 
RealServer G2 RealPlayer G2 RTSP RDT 
RealServer G2 | RTP-based client | RTSP RTP 
RTP-based server RealPlayer G2 RTSP RTP 
RealServer G2 RealPlayer 3.0 to 5.0 | PNA PNA 
RealServer 3.0 to 5.0 | RealPlayer G2 PNA _ PNA 


Compatibility with Previous Releases 


RealSystem G2 is fully compatible with presentations developed for 
RealSystem 3.0 through 5.0. You do not need to change any existing content. 
RealPlayer G2 can play back clips streamed by an earlier version of RealServer. 
As well, RealServer G2 can stream presentations originally created for an 
earlier version of RealSystem. When you create a RealSystem G2 presentation, 
you can use different techniques to make it compatible with earlier versions of 
RealPlayer. 
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SureStream has a Backwards-Compatibility Option 

With RealSystem G2’s SureStream technology, you can encode a single 
RealAudio or RealVideo clip at multiple bandwidths for RealPlayer G2. When 
you encode the clip, you select a backwards-compatibility option to include an 
encoding for earlier versions of RealPlayer. This works only when streaming 
from RealServer G2, however, because Web servers cannot serve SureStream 


clips. 


Additional Information 
For more on backwards compatibility with SureStream, 
see “Encoding RealAudio with RealSystem Tools” on 
page 48 and “Encoding RealVideo with RealSystem 
Tools” on page 58. 


RealServer can Stream Alternate Clips through a Single URL 

If you cannot use a single SureStream clip, create two clips, one for RealPlayer 
G2 and one for earlier versions of RealPlayer. (The RealPlayer G2 clip should 
use the RealAudio G2 codecs for superior sound.) You can then use RealServer 
G2’s altplay option for Ramgen to deliver either clip through a single URL. If 
not using Ramgen, you can create a Ram file that lists both files. 


Additional Information 
See “Using Ramgen” on page 148. For information on 
creating a Ram file, see “Creating a Ram File Manually” 
on page 153. 


Older RealPlayers Receive Upgrade Notice 

To add a new RealSystem G2 feature such as RealText to an existing 
presentation, you need to update the presentation. This includes creating a 
SMIL file and changing the URL in your Web page. Older versions of 
RealPlayer will not be able to play the presentation. But when viewers with 
older versions of RealPlayer click the new link, they are asked to upgrade to 
RealPlayer G2. 


ape. 


as 
Pd | 


CREATING REALSYSTEM PRESENTATIONS FF ) 


RealSystem G2 gives you the power to create compelling, complex 
multimedia presentations streamed over a network. It includes 
RealServer G2, the most advanced streaming media server available, 
along with RealPlayer G2 and RealPlayer Plus G2, the world’s most 
popular desktop applications for playing streaming media clips. 
This chapter explains the basics of how you use RealSystem G2 to 
put together stunning multimedia presentations. 
Tip 
To experience the many possibilities of streaming media, 
download RealPlayer G2 from http://www.real.com, 


and visit http://realguide.real.com and 
http://www.real.com/showcase. 


Streaming Multimedia Clips 


A RealSystem presentation can consist of one clip, such as a single RealAudio 
clip, or multiple clips played in sequence or in parallel. RealSystem streams 
these presentations over a network. If you have ever downloaded a video or 
audio clip to your Web browser, you know that it can take several minutes to 
receive a clip that plays for a few seconds. In contrast, a clip streamed by 
RealServer G2 begins to play back almost immediately. 


Choosing Media to Stream 


RealSystem G2 gives you many possibilities for combining media clips into 
presentations. There are two basic types of file formats you can stream with 
RealSystem G2: 
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« Standard or “open” formats 


Editing programs typically let you save or export files to a standard, 
“open” format. Video editing programs usually let you export files as AVI 
or QuickTime, for example. RealSystem can stream several standard 
formats, but these formats may not be optimized for network streaming. 


- Streaming formats 


Formats such as RealAudio and RealVideo are highly compressed for 

network streaming. These formats give the best results. You can convert a 
file from a standard format to a streaming format with an encoding tool. 
Some editing programs can also export files directly to streaming formats. 


Audio 
Chapter 4 beginning on page 39 discusses the audio formats you can stream: 
* RealAudio (.rm) 
- AIFE (.aif) 
* AU (.au) 
+ WAV (.wav) 
Video 
Chapter 5 beginning on page 51 describes the video formats you can stream: 
+ RealVideo (.rm) 
- ASF (.asf) 
* AVI (.avi) 
* QuickTime (.mov) 
+ Vivo (.viv) 
Animation 
RealFlash, which pairs Macromedia Flash animation with a RealAudio 


soundtrack, lets you stream animated presentations. See Chapter 6 beginning 
on page 63 for details. 


Images 


RealSystem presentations can include still images in these formats: 
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* JPEG (.jpg) 
RealPlayer G2 can display RGB baseline JPEGs. Progressive and grayscale 
JPEGs are not supported. 


+ GIF87, GIF89, and animated GIF (.gif) 


Both interlaced and noninterlaced GIFs will work, but noninterlaced GIFs 
are recommended. 


You can also assemble JPEG and GIF images in a RealPix presentation to 
create eye-catching slideshows with special effects such as dissolves and 


zooms. 
Additional Information 
Download RealPix Authoring Guide from 
http://service.real.com/help/library/encoders.html. 
Text 


RealText streams text at specific times within a presentation. You can use 
RealText to add subtitles to a video, for example, or lay out text from a live 
source to create a real-time stock ticker. 


Additional Information 
Get RealText Authoring Guide, available at 
http://service.real.com/help/library/encoders.html. 


Additional Streaming Formats 

RealSystem’s plug-in technology lets it stream nearly any type of clip or live 
event. Check http://www.real.com/devzone for the availability of plug-ins 
that let RealSystem stream additional video and audio formats, as well as 
exciting new types of media. 


Clip Types Played by Previous RealPlayer Releases 


Most RealPlayer users upgrade when a new version of RealPlayer becomes 
available. If you need to create presentations playable by older versions of 
RealPlayer, though, take into account RealPlayer and clip type compatibility. 
The table below indicates which RealPlayer versions, such as RealPlayer G2 or 
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RealPlayer 5.0, can play which types of clips. RealPlayer 4.0, for example, plays 
only RealAudio and RealVideo. 


RealPlayer Compatibility with RealSystem G2 Clips 


Clip Type G2 5 4 3 2 1 
RealAudio X|X|X]X |X] xX 
RealVideo EGET: r- mS 
RealFlash X/|X}-]-]-]- 
RealPix X | - [E a ee 
RealText X}-|[-]- ie - 
Open formats such as WAV and AVI X | -}-];-]-]- 
SMIL aeaeee 


Note that this table covers general clip compatibility, not codec compatibility. 
Later versions of RealPlayer typically introduce new RealAudio and RealVideo 
codecs. Earlier versions of RealPlayer cannot play the new RealAudio G2 
codecs, for example. So when planning for backwards compatibility, make sure 
you encode RealAudio or RealVideo clips with a codec available in your 
targeted versions of RealPlayer. 


Additional Information 
See also “Compatibility with Previous Releases” on page 
8. For more on codecs, see “Choosing RealAudio 
Codecs” on page 45 and “Choosing RealVideo Codecs” 
on page 57. 


Using Editing and Production Tools 


After choosing your streaming media formats, gather content and use your 
preferred editing tools to prepare your source files. Sound editing software, 
for example, lets you optimize an audio clip’s dynamic range. With video 
editing software you can set the video’s window size. RealSystem does not 
require you to use specific editing tools. Just ensure that your editing tools can 
save files in streaming formats, or in open formats you can easily convert to 
streaming formats. 
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Use Your Favorite Editing Tools to Prepare Media Files 


Audio Video 
Editing Editing 
Station Station 


RealNetworks Production Tools 


If your editing program does not export files to the streaming format you 
want, you can use an encoding tool to convert the file. RealNetworks provides 
free, basic tools, and sells enhanced tools for converting popular sound and 
video formats to RealAudio and RealVideo. In addition, plug-ins for popular 
programs such as Adobe Premiere and Microsoft PowerPoint let you save 
presentations directly as RealVideo. 


RealNetworks Production Tools Create Streaming Clips 


RealAudio 
Clip 


RealVide 
Clip 


Additional Information 
Check http://www.real.com/products/tools/ for the 
tool that’s right for you. 


Additional Tools 


RealSystem G2 provides virtually unlimited possibilities for streaming media. 
It does not lock you into a small set of streaming formats or a specific set of 
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tools. In addition to new types of streaming media, RealNetworks’ partners 
and other parties are continually producing new tools that help you put 
together sophisticated presentations. 


Tip 
Visit http://www.realstore.com to find out about the 
many tools available to help you create streaming media. 
Also check http://www.real.com/devzone frequently 
for information about new media types and tools. 


Working with Timelines and Bandwidths 


As you create streaming media clips, you need to consider how to keep the 
clips synchronized to a single presentation timeline. You also need to create 
presentations for specific bandwidths. These are two important, interrelated 
steps for producing streaming multimedia presentations. 


Synchronizing Clips to a Timeline 


Because a static Web page has no timeline, images and text download without 
a preset order. You may notice when browsing a Web page that one image may 
download partially, then another image begins to appear, then the first image 
completes, and so on. A Web page does not have an internal timeline, so 
exactly when a certain image gets to the browser doesn’t matter. What matters 
is that the entire page downloads as soon as possible. 


When you stream multimedia, though, clips have timelines and must flow 
smoothly once they've started to play back. Imagine how jarring it would be 
for the visual track of a video to play silently for a minute, then pause as its 
audio track catches up to it a minute later. When you stream multimedia, 
therefore, it’s important that your presentation keeps clips synchronized. 
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Clip Timelines Coordinate with an Presentation Timeline 


RealVideo Clip RealPix Clip 


@ll) | 
yl] a 


RealText Clip RealAudio Clip 


Presentation 
Timeline 


There are three aspects of timelines you may work with: 
+ Clips with Internal Timelines 


Audio, video, and animation have internal timelines. In a two-minute 
video, for instance, each frame corresponds to a specific point in a two- 
minute timeline. Each second of audio meshes with each second of the 


visual image throughout the clip’s overall timeline. Your video, audio, or 
animation editing program is your main tool for manipulating the clip’s 
timeline, which is woven into the fabric of the clip. 


+ Clips with Variable Timelines 


With RealPix or RealText, you define timing tags that set when each image 
or text block appears. You thereby control exactly how long each image or 
text chunk stays on the screen. When combining clips, it’s typically easier 
to produce audio, video, or animation first. Then set the RealPix and 
RealText timelines to coordinate with those clips. 


Additional Information 
Get the RealPix and RealText authoring guides from 
http://service.real.com/help/library/encoders.html. 


+ SMIL Timing Commands 


A SMIL file assembles your presentation and can include its own timing 
elements. Timing a presentation with SMIL can be as simple as starting 
one clip as soon as another one stops. But you can also use explicit timing 
commands to delay playback for ten seconds, for example, or start a clip 
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playing at 30 seconds into its internal timeline. SMIL’s timing commands 
are optional, but they give you an extra level of flexibility you may need 
when putting multimedia clips together. 


Additional Information 
“Writing a SMIL File” on page 18 provides an overview 
of SMIL. For specifics on SMIL timing, see “Specifying 
Timing” on page 84. 


Keeping a Bandwidth Budget 


Any presentation streamed over a network has a bandwidth budget because 
each person viewing streaming clips has a network connection with a top 
speed, such as 28.8 Kilobits per second. Even when your clips are perfectly 
synchronized, the presentation may stall if at some point it requires more 
bandwidth than the viewer has available. This happens because RealServer 
needs to transmit at a certain point in the timeline more data than can get 
through the network connection to RealPlayer. 


When you develop a streaming media presentation, you need to consider the 
bandwidth constraints your audience will have. This is crucial for creating 
presentations that start to play back quickly and flow smoothly. Web users 
don’t like to wait more than a few seconds for something to happen after they 
click a link. And if your clips stop and restart frequently, viewers are not likely 
to stay watching. Fortunately, RealSystem offers sophisticated features that let 
you create a single presentation that looks good over a slow connection and 
great over a fast one. 


Additional Information 
Chapter 3 beginning on page 27 provides the details for 
considering bandwidth in streaming presentations. 


Writing a SMIL File 


With your clips in their streaming formats, you put your presentation 
together with SMIL. Pronounced “smile,” SMIL stands for “Synchronized 
Multimedia Integration Language.” A SMIL file is not necessary to stream just 
one clip. But when you have multiple clips, SMIL’s =n mark-up language 
specifies how and when the clips play. 
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Advantages of Using SMIL 


Coordinate Clips 
on Different Servers 


Lay Out 
Presentations» 


Support 
Multiple 
PPinguaces 


_Willkomen_ ‘ 
BUENAS DIAS: 


Advertisements ustomize Presentations 


Here are some of the many advantages of using SMIL: 
- Avoid Using Container Formats 


Because RealSystem can stream many media formats, you do not need to 
merge clips into a single streaming file. To alter your presentation, for 
example, you simply edit the SMIL file rather than merge the clips again 
into a different container file. 


Use Clips in Different Locations 


Because a SMIL file lists a separate URL for each clip, you can put together 
presentations using clips in any locations. You can use a video clip from 
one server, for example, and a text clip from another. 


Support Multiple Languages 


A SMIL file can list different language options for clips. To create a video 
with soundtracks in different languages, for example, you produce one 
video clip with no soundtrack, then create audio clips in each language. 
Your Web page needs just one link to the SMIL file. When a visitor clicks 
that link, the visitor’s RealPlayer chooses a soundtrack based on its 
language preference. 
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Support Multiple Bandwidths 


A SMIL file can also list presentation choices for different bandwidths. 
RealPlayer then chooses which clips to receive based on its available 
bandwidth. You can thereby support multiple connection speeds through 
a single hypertext link, rather than separate links for modem users, ISDN 
users, T1 users, and so on. 


Note 
RealSystem G2’s SureStream technology also lets you 
support multiple bandwidth connections within a 
single clip. For more information, see “Supporting 
Multiple Bandwidth Connections” on page 34. 


Put Together Customized Presentations 


Because a SMIL file is a simple text file, you can generate it automatically 
for each visitor. You can therefore create different presentation parts, then 
assemble a customized SMIL file based on preferences recorded in the 
visitor’s browser. 


Time and Control the Presentation 


The SMIL file lets you easily control the presentation timeline. You can 
start an audio clip playing at 2.5 seconds into its internal timeline, for 
example, without changing the encoded clip. 


Lay Out the Presentation 


When your presentation includes multiple clips, such as a RealVideo clip 
playing simultaneously with a RealPix slideshow, you use SMIL to define 
the layout. 


Include Ads 


You can use SMIL along with RealServer’s Advertising Application to 
insert ads into your presentation. RealServer can deliver image banner ads, 
as well as rich media ads in formats such as RealVideo and RealFlash. 


Additional Information 
Chapter 7 beginning on page 75 describes the SMIL file 
syntax. Chapter 9 beginning on page 137 explains ad 
insertion. 
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Hosting a Presentation on a Server 


When your presentation is complete, you move the streaming media clips and 
SMIL file to RealServer G2 or a Web server for delivery. You can play back your 
presentation in RealPlayer or directly in your Web page. The latter option, 
which uses RealPlayer’s Netscape plug-in or ActiveX Control, requires mark- 
up tags in your Web page that specify how the presentation displays. 


Additional Information 
Beginning on page 145, Chapter 10 explains how to link 
your Web page to a RealSystem presentation hosted ona 
server. For information on embedding a presentation in 
your Web page, see Chapter 8 on page 117. 


Using RealServer G2 or a Web Server 


RealServer G2 is the preferred host for RealSystem presentations. Designed 
specifically to stream multimedia over networks, RealServer keeps multiple 
clips synchronized and uses many advanced features to ensure that clips 
stream smoothly under adverse network conditions. Although you can use a 
standard Web server to host some streaming presentations, you will not get 
the results you’ll experience when using RealServer. 


Tip 
If you don’t have RealServer G2 available, check out the 
hosting services of Real Broadcast Network (RBN) at 
http://www.real.com/rbn. RBN provides full services 
for encoding, hosting, and broadcasting events to small 
or large audiences. 


Web Server HTTP and RealServer RTSP 


A Web server uses the HTTP protocol, as you can see in Web page URLs that 
begin with http://. The HTTP protocol downloads files without regard to 
timelines, making clips with timelines more likely to stall. Although 
RealPlayer can play back clips as they download, the HTTP protocol does not 
give RealPlayer the ability to adjust the download to compensate for changing 
network conditions. 


In contrast, URLs for media clips streamed by RealServer begin with rtsp://, 
because RealServer uses Real-Time Streaming Protocol (RTSP), which is 
designed specifically to stream clips that have timelines. RTSP lets RealPlayer 
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G2 and RealServer G2 exchange information about a presentation in progress 
and adjust the streaming data to keep the clips playing smoothly. 


RealServer RTSP Streaming vs. Web Server HTTP Downloading 


Streaming 


rtsp://realserver.company.com 


RealPlayer 
RealServer 


Downloading 


http:/Awww.company.com 
Web Server RealPlayer 


When two clips play side-by-side, for example, RealPlayer uses RTSP to 
communicate with RealServer about each clip’s progress, indicating how 
much data it needs to keep the presentation synchronized. RealServer can 
then adjust the data flow, reducing low priority data if necessary to ensure 
that crucial data gets through. Communication like this is not possible when 
a Web server sends clips to RealPlayer. 


You don’t need to know the specifics of RTSP to create great presentations. 
You just need to ensure that RealServer G2 is available to stream your clips. If 
only a Web server is available, you can still create multimedia presentations, 
but you won’t be able to use all RealSystem features. In either case, make sure 
you have a good understanding of RealSystem G2 production as described in 
this manual before you start creating your clips. This helps ensure that your 
presentation harmonizes with the server that hosts it. 


Additional Information 
For information on RealSystem features that do not 
work with Web server hosting, read “Limitations on Web 
Server Playback” on page 151. 


Launching a Presentation 


Because some browsers may not be configured to launch RealPlayer when they 
receive a SMIL file or a media clip, you need to ensure that RealPlayer launches 
when a visitor to your Web page clicks the link to your presentation. When 
RealServer G2 hosts your presentation, you simply include a Ramgen 
parameter in the Web page URL to launch RealPlayer. 
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Additional Information 
For more on Ramgen, see “Streaming Clips from 
RealServer G2” on page 146. 


When a Web server hosts your presentation, you launch RealPlayer by linking 
your Web page to a Ram file instead of a SMIL file or a media clip. When the 
browser receives the Ram file, it launches RealPlayer and gives it the Ram file, 
which contains the URLs to your media clips or SMIL file. RealPlayer uses this 

' information to request the presentation from the Web server. Because the 
Ram file is a small text file, this interaction takes little time. 


Additional Information 
For more on Web server playback, see “Playing Clips 
from a Web Server” on page 149. 


Working with the RealServer Administrator 


Because earlier versions of RealServer do not handle SMIL files and many of 
the RealSystem G2 clip types, make sure you have RealServer G2 available to 
host your presentation. When you host a presentation on RealServer G2, the 
RealServer administrator will give you the basic URL parameters, such as the 
server address and its RTSP and HTTP port parameters. The RealServer 
administrator can also set up many content delivery and security features, 
such as: 


+ live broadcasts 
* pay-per-view content 
* automatic ad insertion 


* password authentication 


Additional Information 
RealServer Administration Guide, available at 
http://service.real.com/help/library/servers.html, 
explains RealServer features. 


Using RealNetworks Logos 


When you create RealSystem G2 content, RealNetworks encourages you to 
add RealSystem G2 logos to your Web page. You can provide a RealPlayer G2 
download link button, for example, so that users can get RealPlayer G2 from 
RealNetworks’ site and view your content. You can read RealNetworks’ 
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trademark policy and get RealSystem G2 and RealPlayer G2 logos from 
http://www.real.com/company/guide/index.html. 


Playing Clips Back Locally 


Although the main function of RealSystem is to stream media clips over a 
network, you can also create presentations that play back from a uset’s local 
machine. An example is a multimedia-enhanced book written with HTML and 
containing links to RealSystem clips. Users then download all the book files 
to their local machines and play back the media clips in RealPlayer. 


In this case, you produce clips as described in this manual, except that you 
don’t have to target specific network bandwidths. When you put the 
presentation together, you simply use URLs that point to clips on the user’s 
machine instead of on RealServer or a Web server. 


Additional Information 
For more on local URLs, see “Linking to Local Clips” on 
page 80. 


Viewing a Presentation with RealPlayer 


With RealPlayer G2 installed, you simply click the presentation link in your 
Web page to view the media clips. RealPlayer buffers the clips for a few 
seconds, then begins to play the presentation back in its own window or your 
browser. RealPlayer downloads are available from RealNetworks at 


http://www.real.com. 


Protecting Copyrighted Content 


Unlike a Web browser, RealPlayer does not store clips in a disk cache or allow 
users to copy or download still images. This helps you keep copyrighted 
material secure when you stream clips from RealServer. Optionally, 
RealNetworks tools let you encode video and audio clips so that viewers can 
record the streamed clips to their local machines. 


Downloading RealPlayer Plug-Ins 


RealPlayer can play virtually any streaming clip because of its plug-in 
technology. RealPlayer plug-ins function like Web browser plug-ins. When 
RealPlayer receives a streaming RealVideo clip, for example, it uses its 
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RealVideo plug-in to play the clip on your computer screen. If RealPlayer 
doesn’t have a plug-in needed to play a certain streaming clip, it downloads 
that plug-in from the Internet. 


RealPlayer Downloading a New Plug-in 


World Wide Web 


RealVideo 
RealText 


RealPlayer 


Plug-in downloading lets you confidently develop presentations using the 
latest streaming file types available for RealSystem. If visitors to your Web 
page don’t have a plug-in needed to play your presentation, RealPlayer quickly 
downloads the plug-in and can play the presentation without having to 
restart. Because RealPlayer is the world’s most popular application for playing 
streaming media, you can be sure that your RealSystem G2 presentation can 
reach the widest audience possible. 


Additional Information 
For information about developing RealPlayer plug-ins 
or building RealPlayer capabilities into an application, 
visit http://www.zeal.com/devzone/realdevelopers/. 
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Targeting a network connection’s bandwidth is crucial for delivering 


TARGETING BANDWIDTH 


a successful streaming media presentation. Web users with 28.8 
Kbps modems, for example, need to view presentations that require 
less than 28.8 Kilobits of data per second. As the first step in 
building your presentation, target a bandwidth and create content 
with that connection speed in mind. This helps ensure that the 


presentation streams smoothly. 


Note 
The only time you do not need to consider bandwidth is 
when all clips in your presentation reside on users’ local 
computers rather than on RealServer or a Web server. 


What is Bandwidth? 


Total bandwidth is the upper limit on how much data can pass through a 
network connection per second. Internet bandwidth is described in Kilobits 
per second (Kbps). A 28.8 Kbps modem, for example, can receive data at any 
speed up to 28.8 Kbps. Bandwidth is analogous to a speed limit, such as 60 
m.p.h. A presentation's bit rate is analogous to car speed. Based on variables 
such as weather and traffic, a car may be able to travel only 30 m.p.h. Due to 
network congestion and server load, a 28.8 Kbps modem may receive 11 Kbps 
of data one minute, 22 Kbps of data another. 


When you drive on a highway, you have no control over weather and traffic 
that makes you slow down. Under good conditions, though, you can observe 
the speed limit. Likewise with your presentation, you have no control over 
server load and network congestion when someone views your presentation. 
You can, however, ensure that your presentation does not exceed the user's 
bandwidth. On the highway, breaking the speed limit gets you a ticket. On the 
Internet, exceeding bandwidth stalls your presentation. 
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For example, a 28.8 Kbps connection can still play a presentation that requires 
a 56 Kbps stream. But the modem takes around two seconds to receive the 
data that RealPlayer has to play every second. In other words, data has to be 
displayed faster than it comes in over the modem. Consequently, RealPlayer 
does not begin playback until it receives and stores (“buffers”) enough data to 
play the presentation without halting. For a long presentation, this may take a 
few minutes. Viewers are not likely to wait that long. 


Presentation Data Must Fit RealPlayer’s Bandwidth 


RealServer RealPlayer 


ar 
HOS 6S 06408808 e & 
28.8 Kbps 28.8 Kbps Modem 


CA CO 


56 Kbps 7 


» Seaeeeesaeees 2 
esSegcsesee 
ae 586 Kbps of Data Stalled 


28.8 Kbps Modem Presentation 


Designing content suitable for viewers' available bandwidths is crucial to 
delivering compelling multimedia presentations. Because most Internet users 
have 28.8 Kbps modems, content available to the public should target that 
bandwidth. If your presentation is for high-speed intranet use only, you may 
be able to target a higher minimum bandwidth. Additionally, you can target 
multiple bandwidths with a single clip that looks good at low bandwidths and 
great at high bandwidths. 


What is Preroll? 


Preroll is the initial data that RealServer sends to RealPlayer before playback 
begins. Before it delivers a presentation, RealServer looks at the clip sizes and 
the timeline. Weighing these against the connection bandwidth, RealServer 
determines how much data RealPlayer must receive before starting to play the 
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presentation. The preroll helps ensure that once RealPlayer commences 
playback, it does not need to halt the presentation while it receives more data. 


As a general rule, you want preroll to be under 15 seconds, ideally under 10 
seconds. If your presentation requires more bandwidth than the user’s 
connection can supply, the presentation can still play back, but it requires a 
lengthy preroll and users are not likely to watch long while nothing happens 
on screen. Sticking to your bandwidth target helps keep presentation preroll 
to an acceptable level. 


Choosing a Target Bandwidth 


The target bandwidth of a RealSystem G2 presentation is the maximum 
bandwidth available for a network connection, such as a 28.8 Kbps modem. 
The presentation's total bit rate must be at or below the target bit rate. The 
total bit rate comprises two main parts: 


» Maximum bit rate consumed by all streaming clips. For a multiclip 
presentation, this can vary over time. You therefore want to consider what 
part of your presentation consumes the most bandwidth and use that 
peak point as your guideline. 


+ 25% of target bit rate for overhead (noise, data loss, and packet overhead). 
This is an approximation. Overhead can vary depending on the type of 
connection and general network conditions. A 56 Kbps modem typically 
requires more overhead than a 56 Kbps ISDN connection, for example. 


If your target bit rate is 28.8 Kbps, for example, take 75% of that rate as the 
bandwidth available for your streaming clips. For a 28.8 Kbps connection, you 
have approximately 20 Kbps total for your presentation. The following table 
lists the recommended maximum bit rates for streaming presentations over 
various network connections. 


Bit Rates Available for Streaming Clips 


Recommended Maximum Bit 


Target Connection Speed Rate for Streaming Clips 
14.4 Kbps modem 10 Kbps 
28.8 Kbps modem | 20 Kbps 
56.0 Kbps modem 32 Kbps 
56.0 Kbps ISDN 45 Kbps 


112 Kbps dual ISDN 80 Kbps 
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Developing a Bandwidth Strategy 


Once you know the bit rate or rates available for your streaming clips, you can 
begin to develop your bandwidth strategy. If you want to stream just one clip, 
your strategy is straightforward. Things become more complex, though, when 
you combine different clips into one presentation. But with some practice, you 
will quickly learn how to balance bandwidth requirements with presentation 


quality. 


Understanding Clip Bandwidth Characteristics 


The first step in planning your multimedia presentation is to understand the 
bandwidth characteristics of your clip or clips. The following sections describe 
characteristics for standard RealSystem media types. If you stream other types 
of clips, make sure you understand each clip’s bandwidth characteristics. 


RealAudio 

RealAudio consumes bandwidth at a flat rate determined by the codec used to 
encode the clip. If you have a RealAudio clip encoded with an 8 Kbps codec, 
for example, that clip will steadily consume 8 Kbps of bandwidth as long as it 
plays. And with SureStream technology described in “Using SureStream Clips 
for Multiple Bandwidths” on page 35, you can encode a single RealAudio clip 
for up to six bandwidths. 


Additional Information 


See “Choosing RealAudio Codecs” on page 4S. 


RealVideo 

RealVideo consumes bandwidth at a flat rate for a given bandwidth target. If 
you target 20 Kbps and use an 8 Kbps RealAudio codec for the soundtrack, the 
image track steadily consumes 12 Kbps. RealVideo encoders vary a clip’s frame 
rate and image quality to produce the best possible quality for the bandwidth 
target. SureStream technology described in “Using SureStream Clips for 
Multiple Bandwidths” on page 35 lets you encode a single RealVideo clip for 
up to six bandwidths. 


Additional Information 
See “Choosing RealVideo Codecs” on page 57. For tips 
on shooting video, see “Recording Video” on page S3. 
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RealFlash 

The Shockwave Flash component of a RealFlash presentation has a spiky 
bandwidth characteristic, meaning it consumes a lot of bandwidth at certain 
points in its timeline, little bandwidth at other points. RealNetworks provides 
tools that help you optimize RealFlash for a specific bandwidth. 


Additional Information 
If you plan to create streaming animation, read 
“Preparing a RealFlash Clip” on page 63. 


RealText 

RealText consists of a text file that contains the RealText mark-up. Because it 
uses just a simple text file, RealText consumes little bandwidth. This makes it 
easy to add RealText to any presentation. 


Additional Information 
For more on RealText, get RealText Authoring Guide from 
http://service.real.com/help/library/encoders.html. 


RealPix 

RealPix consists of still images streamed to RealPlayer. Its bandwidth 
consumption depends on the number and size of the images, as well as how 
quickly you stream them. RealPix therefore gives you a lot of control over 
bandwidth usage through your choice of images and how you construct the 
RealPix timeline. 


Additional Information 
For more on RealPix and its bandwidth characteristics, 
refer to RealPix Authoring Guide, which is available at 
http://service.real.com/help/library/encoders.html. 


Images 

By default, JPEG and GIF images rendered directly in RealPlayer (that is, 
images that are not part of a RealPix presentation) stream at 12 Kbps. You can 
modify this bit rate through a SMIL file. 


Additional Information 
See “Defining Image Options” on page 111 for more on 
using SMIL to change image clip bandwidth use. 
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Delivering a Single Media Clip 


Suppose you want to create an audio clip that Web users with 14.4 Kbps 
modems can play. You can simply create a RealAudio clip that consumes 8 
Kbps of bandwidth. Anyone with a 14.4 Kbps or higher connection can then 
listen to your presentation. However, when a clip has multiple streams, such as 
a video that contains a visual track and an audio track, you need to consider 
how much bandwidth goes to each stream. 


Suppose you want to stream a RealVideo clip at 28.8 Kbps. How much 
bandwidth should you give to the visual track and how much to the audio 
track? The answer depends on the content. Because music has a greater 
frequency range than voice, a music video requires more audio data than a 
“talking heads” interview. Hence a soundtrack with music consumes more 
bandwidth than one that uses just speech. 


The more you increase the audio track’s bandwidth, however, the more you 
have to decrease the visual track’s bandwidth. If you start with a huge video 
source file, your RealVideo encoding tool may discard a lot of the source data 
to make the encoded RealVideo data fit a certain bandwidth. Although the 
RealVideo clip will be playable, you may not like the results. Motion might 
appear too jerky, for example, or fast-moving images might not resolve 
visually. 


Possible Audio and Video Tracks in a 20 Kbps RealVideo Clip 


The point here is that even when you stream just a single clip, your bandwidth 
target affects how you create content. If you know you'll have only a small 
bandwidth for video, for example, you can optimize the visual content to 
display in a small window at a slow frame rate. You may need to jettison 
panoramic and fast action shots that won’t fare well under these constraints. 
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Additional Information 


See “Recording Video” on page 53. 


Developing Multiclip Presentations 


An exciting aspect of RealSystem G2 is that you can develop multimedia 
presentations, such as slideshows with audio voice-overs, or video with 
scrolling subtitles. When multiple clips play together, you need to consider 
how much presentation bandwidth to allot each clip. While it’s exciting to 
create presentations that include video, slideshows, audio, and scrolling text 
all at once, viewing such presentations over slow modems may be difficult. 


The following figure illustrates a poor presentation for a low-bandwidth 
connection. The multiclip presentation starts with RealVideo and RealPix 
clips that require more than the target bandwidth at first. Bandwidth use, 
illustrated by the solid line, peaks again when the second RealVideo clip 
begins to play concurrently with the first video clip. To even out the 
bandwidth spikes, RealSystem streams a high preroll for the RealPix and 
RealVideo clips, making the presentation slow to start and likely to stall 
during transitions between clips. 


Poor Bandwidth Use in a Multiclip Presentation 


RealVideo 
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: > ____RealVideo__> 
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The next figure shows better bandwidth management. The presentation starts 
with a low-bandwidth RealText clip that does not interfere with streaming the 
images in the RealPix clip. A RealVideo clip starts after the RealPix clip has 
streamed all its images and does not need bandwidth. The second RealVideo 
clip starts after the first RealVideo clip has ended, so the two video clips do 
not compete for bandwidth. 
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Improved Bandwidth Use in a Multiclip Presentation 


CPW D RIEL IPOD GOT AOE Sy ERE A AIS NN RE AEE MAUNA 


Tips for Creating Multiclip Presentations 
When developing a streaming multimedia presentation, keep the following 
tips in mind: 

- Consider the presentation timeline carefully to eliminate bandwidth 
bottlenecks. These typically occur when two or more high-bandwidth 
clips play simultaneously. You may need to omit high-bandwidth pairings, 
combining high-bandwidth with low-bandwidth clips instead. 


Stagger the times when clips begin to play back. Every clip requires a 
certain preroll before RealPlayer can play it. Your presentation will play 
more smoothly if RealServer does not need to send more than one clip’s 
preroll at a time. 


Start presentations with low-bandwidth clips. Use RealText to display 
credits, for example. Or begin with a highly compressed RealAudio 
narration before bringing in video. RealSystem can take advantage of the 
extra bandwidth to begin streaming higher bandwidth data to RealPlayer 
“behind the scenes.” 


Additional Information 
See “Smoothing Transitions between Clips” on page 
173. 


Test presentations in “real world” circumstances, replicating your 
audience’s bandwidth conditions. Clips may play back fine when the files 
reside on your desktop computer. The presentation may bog down, 
though, when you stream the clips over a modem. 


Supporting Multiple Bandwidth Connections 


To reach a wide audience on the Internet, you need to provide content that can 
play over slow connections. You can encode a RealAudio clip at 8 Kbps, for 
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example, so that anyone with a 14.4 Kbps or higher connection can play it. 
This clip will have good quality sound. But the same clip encoded as a 16 Kbps 
clip will have better sound. Encoded for 32 Kbps delivery, the clip will have 
even greater frequency response and dynamic range. 


To provide good content for users with slower connections and great content 
for those with faster connections, you can use two methods, and even mix 
them depending on your needs. With the first method, you create a single clip 
that targets different bandwidths. In the second method, you create separate 
clips for each bandwidth target and let RealPlayer choose which set of clips to 
play. Either way, you add to your Web page just one link for all visitors. You 
don’t need separate links for modems and ISDN connections, for example. 


Using SureStream Clips for Multiple Bandwidths 


With RealSystem’s SureStream technology, you can encode a RealAudio or 
RealVideo clip for up to six different bandwidths using new RealSystem G2 
codecs. For example, you can encode a single RealAudio music clip for 28.8 
Kbps modems, 56 Kbps modems, 112 Kbps dual ISDN, and T1 connections. 
Your Web page links to this single clip, and when a visitor clicks the link, 
RealPlayer and RealServer determine which encoding to use based on the 
available bandwidth. The following figure illustrates this. 


SureStream Clip Encoded for Multiple Bandwidths 
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RealServer and RealPlayer can even adjust this choice to compensate for 
network conditions. If a fast connection becomes bogged down because of 
high network traffic, RealServer seamlessly switches to a lower bandwidth 
encoding to prevent the presentation from stalling. When the congestion 
clears, RealServer switches back to the higher bandwidth encoding. 
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Switching Bandwidths During Network Congestion 
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Additional Information 
For more on RealAudio and SureStream, see “Choosing 
RealAudio Codecs” on page 45. See also “Choosing 
RealVideo Codecs” on page 57. 


Letting RealPlayer Choose between Multiple Clips 


If your presentation uses clips other than RealAudio or RealVideo, you can 
create multiple versions of the clips for different bandwidths. When you 
assemble your presentation, you use a SMIL file to designate a bandwidth 
connection for each of the different groups. When a user clicks your Web page 
link, RealPlayer receives the SMIL file and chooses which clip group to play 
based on its own connection speed. 


The following figure illustrates a SMIL file that lists two choices between 
RealPix clips, a high-bandwidth choice and a low-bandwidth choice. 
RealPlayer chooses which clip to receive based on its connection speed and the 
SMIL file’s bandwidth parameters. Both presentations use the same 
RealAudio file, which has been encoded for multiple bandwidths. 
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Bandwidth Choices through SureStream Clip and SMIL 
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Because each connection speed uses a different set of clips, RealServer cannot 
switch between the different encodings as it can with a single SureStream clip. 
RealServer employs other techniques, however, to compensate for network 
congestion. Its advanced stream thinning capabilities let it drop low-priority 
data to decrease the presentation bandwidth temporarily. When the 
congestion clears up, it continues to stream all the presentation data. 


Additional Information 
“Setting Bandwidth Choices” on page 90 explains how 
to use a SMIL file to designate different bandwidth 
groups. See also “Switching with SureStream Clips” on 
page 176. 
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PRODUCING AUDIO 


RealNetworks pioneered streaming audio with RealAudio, the first 
streaming media product for the Internet. Since its debut in 1995, 
RealAudio has become the standard for network audio, delivering 
stereo sound over 28.8 Kbps modems, and CD-quality sound at high 
connection speeds. RealSystem G2 can stream other audio formats 
as well. This chapter explains how to prepare and encode your sound 


files for streaming. 


Steps for Streaming RealAudio 


To produce a great RealAudio clip, you need to use great source material, 
high-quality equipment, and good production practices. This section provides 
a quick overview of the steps involved in streaming a RealAudio clip. 


Creating a RealAudio Clip 


1. Capture Audio 2. Optimize Audio 


& 
a 
3. Encode RealAudio 


nw, 


RealAudio 


RedlAudio Encoder RealAudio RealPlayer 
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> To create a streaming RealAudio clip, follow these basic steps: 


1, Capture audio. 


You start audio production by capturing audio from a source, such as a 
person speaking into a microphone. You might also start with a digitized 
audio source file from a compact disc, for example. 


Additional Information 
“Capturing Audio” on page 41 provides guidelines for 
capturing audio. 


2. Optimize audio. 


With the audio file digitized in a common file format, such as WAV or 
AIFF, you next use a sound editor to optimize the audio for streaming. 
When broadcasting live, however, you encode the streaming audio directly 
from the source, optimizing the audio source during the capture. 


Additional Information 
See “Optimizing Audio” on page 43 for tips on sound 
editing. For more on live broadcasting, read Chapter 11 
starting on page 159. 


3. Encode RealAudio clip. 


With your digitized file optimized or your live broadcast ready to go, you 
encode your source in the RealAudio format. When you do this, you 
choose a codec or set of codecs that target a network bandwidth. 


Additional Information 
“Creating RealAudio Clips” on page 44 explains 
RealAudio and its codecs. As described in “Streaming 
Other Audio Formats” on page 49, RealSystem G2 can 
stream other audio formats as well. 


4. Deliver RealAudio clip. 


With your presentation is ready to go, you make your RealAudio clip or 
broadcast available through your Website. To combine sound with 
another streaming clip, such as RealPix, you write a SMIL file. 


Additional Information 
Chapter 7 starting on page 75 explains how to create a 
SMIL file. See Chapter 10 beginning on page 145 for 
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instructions on linking your Web page to a RealAudio 
clip or a SMIL file. 


Capturing Audio 


A streaming audio clip reflects the quality of the audio source. Degradations 
in sound quality within the audio source affect the final streaming audio clip. 
The following sections will help you capture high-quality audio source files or 
broadcasts. 


Broadcasting live audio introduces several issues beyond those you need to 
consider when creating a standard clip. This is because you cannot edit a 
broadcast the way you can edit a digitized audio file. When broadcasting, 
though, you can set up your sound equipment to capture high-quality sound 
before encoding it. 


Additional Information 
For pointers on producing video, see “Recording Video” 
on page 53. 


Use High-Quality Source Media 

Ifyou plan to stream existing material, start with the best source possible. Use 
the cleanest recording with the least amount of unwanted noise. Compact disc 
(CD) and digital audio tape (DAT) are good source media, although well- 
recorded analog sources such as records, reel-to-reel tapes, and chrome (type 
II) cassettes can sound just as good. Try to avoid “consumer grade” recording 
media such as Type I cassettes and VHS tapes. 


Choose Professional Recording Equipment 

Every piece of equipment in the audio chain—microphone, mixer, sound card, 
and so on—affects sound quality. If you intend to provide professional-quality 
audio content, invest in professional audio equipment and software. Poor- 
quality equipment can add hiss and distortion, degrading sound clarity. 


Use Shielded Cables 

It is important to use high-quality, shielded cables. Unshielded cables increase 
the chance of introducing line noise and Radio Frequency Interference (RFI) 
into recordings. Keep audio cables physically separated from power cords to 
minimize the introduction of noise. Also be sure to ground all equipment 


properly. 
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Set Input Levels Correctly 

Setting correct input levels is crucial. All audio equipment has a signal-to- 
noise ratio, the ratio between the loudest possible sound the equipment can 
reproduce without distortion and its inherent noise floor. This distortion is 
known as “clipping,” and is audible as a high-frequency crackling noise. 


To get the best signal-to-noise ratio, set the input level on each audio device in 
the signal chain so that it utilizes its full range of available amplitude without 
distortion during the program’s loudest sections. The signal chain typically 
includes a microphone, a mixing desk, a compressor, and a sound card. For 
each piece of equipment, set levels as close as possible to 0 dB without going 
over. 


Check at each point in the signal chain for signal distortion. Perform several 
test runs and make sure there are no peaks above maximum amplitude. Adjust 
levels on your sound card mixer so the input approaches but does not exceed 
the maximum. Be conservative, though. Levels might suddenly increase if, for 
instance, an interviewee suddenly speaks loudly or a crowd at a sports event 
roars. 


Prepare Volume Levels for Live Broadcasts 

When broadcasting live audio, it is useful to have a dynamics compressor (gain 
compression, not data compression), which is a piece of audio equipment that 
automatically adjusts the volume level. By providing a consistent level, the 
compressor allows you to “set and forget” the input levels to the RealAudio 
encoder. 


Use Optimum RealAudio Sampling Rates 

Try to capture sound with a sampling width of 16 bits. RealAudio codecs have 
different sampling rates that produce the best sound, however. If your sound 
card allows it, capture audio at the optimum sampling rate for the codec you 
intend to use. The RealAudio encoder will convert the file to the optimum rate 
if necessary, but this is recommended only for static files. For live broadcasts, 
use a sound card that supports the optimum rate. This avoids the overhead of 
converting the rate while encoding in real-time. 


Additional Information 
The tables beginning on page 46 list the optimum 
sampling rates for each codec. 
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Tip 
You do not need to capture stereo sound if you plan to 
use a mono codec. However, many sound cards simply 
discard the right input channel in mono mode. If you 
have a mixing desk, pan all inputs to the center so the 
conversion to mono loses nothing. 


Optimizing Audio 
If you are not broadcasting audio live, you work with a digitized audio source 
file in a supported format such as WAV, QuickTime, or AIFF. You then edit the 
audio file to optimize it. To do this, you need to be familiar with the editing 
functions your audio editing program offers. The following sections give some 
optimization tips you can carry out with your audio editing software. 


DC Offset 

DC Offset is low-frequency, inaudible noise that results from equipment 
grounding problems. If you don’t remove it, it can skew the results of 
subsequent sound editing. Use your sound editor’s DC Offset function 
immediately after recording a digital audio file. 


Tip 
If your sound editing program allows it, eliminate DC 
offset during recording. This saves you an editing step. 


Normalization 

Set sensible input levels when recording, then use normalization to maximize 
levels after recording. Your streaming files sound best when your digitized 
source has the highest possible gain without clipping. Digital audio files that 
do not utilize their full amplitude range produce low-quality streaming clips. 
If the amplitude range is too low, use your sound editor to adjust the range 
and increase the amplitude. 


Tip 
Most sound editors have a Normalize function that 
maximizes levels automatically. Because some systems 
have trouble with files normalized to 100%, normalize 
to 95% of maximum, or to -0.5dB. 
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Dynamics Compression 

Normalization maximizes the input level of the audio file’s loudest sections. 
Consequently, quiet sections may not encode as well. Dynamics compression 
evens out input levels by attenuating (turning down) the input when it rises 
above a threshold. Check your audio software for a Compression or Dynamics 
feature. You can control attenuation by specifying a compression ratio. This 
turns down the loudest sections, and you can readjust input levels accordingly. 


Tip 
For multipurpose dynamics compression, set the 
threshold to -10dB, the ratio to 4:1, and the attack and 
release times to 100ms. Adjust the input level to get 
around 3dB of compression and an output level around 
OdB. 


Equalization 

Equalization (EQ) changes the tone of the incoming signal by “boosting” 
(turning up) or “cutting” (turning down) certain frequencies. Using EQ, you 
can emphasize certain frequencies and cut frequencies that contain noise or 
unwanted sound. EQ can compensate for RealAudio codecs that do not have 
flat frequency responses (that is, codecs for which certain frequencies are not 
as loud after encoding). You can therefore use EQ to make a RealAudio clip 
sound as close as possible to the initial recording. 


Tip 
For voice-only content, you can make the file more 
intelligible by cutting frequencies below 100 Hz and 
carefully boosting frequencies in the 1-4 kHz range. 


Creating RealAudio Clips 


RealAudio is a compressed format suitable for streaming over the Internet or 
intranets. A RealAudio clip generally uses .rm as its file extension, but .ra is 
also acceptable. Because RealAudio is compressed, you typically start with a 
sound file in a digitized, uncompressed format such as WAV or AIFF. You then 
create a RealAudio clip from this source file through an encoding tool. Your 
encoding tool should be able to accept some or all of these input formats: 


- Audio Interchange Format (.aif) 


+ Audio (.au) 
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+ MPEG-1 (.mpg) 

* QuickTime (.mov) 
» Sound (.snd) 

» WAV (.wav) 


Additional Information 
RealAudio production tools are available at 


http://www.real.com/products/tools/. 


Choosing RealAudio Codecs 


RealAudio uses a “lossy” compression scheme that discards parts of the audio 
source file to achieve a highly reduced file size. A RealAudio clip encoded from 
a WAV source file, for example, may be 10 to 20 times smaller than the WAV 
file. Although discarding audio information during encoding lowers the clip’s 
frequency response and dynamic range, carefully choosing codecs minimizes 
the impact of compression. 


A RealAudio encoding tool uses a codec to compress the original sound file 
and create a RealAudio clip. RealPlayer uses the same codec to decompress the 
streamed RealAudio clip for playback. When you encode a RealAudio clip, you 
choose a codec (or series of codecs) based on two criteria: 


1. Bandwidth 


As Chapter 3 beginning on page 27 explains, you need to decide how 
much bandwidth each part of your presentation will consume. When you 
have a bandwidth target for your audio component, you can choose a 
codec that encodes RealAudio at or below that target. 


2. Audio Content 
RealAudio uses different codecs for music and spoken voice. Voice codecs 
focus on the standard frequency range of the human voice. Music codecs 
have broader frequency response to capture more of the high and low 
frequencies. 


The following tables provide a reference for all RealAudio codecs. Note that 
your encoding tool may not include all codecs listed. The tables give the 
following information: 
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¢ G2, 5, 4, 3,2, 1 
An “X” in these columns indicates that a clip encoded with this codec can 
be played by RealPlayer G2, 5.0, 4.0, and so on. With RealSystem’s 
SureStream technology, you can encode a single clip for up to six 
bandwidths using the RealAudio G2 codecs. Only RealServer G2 can 
stream SureStream clips, though, as they require a large download time if 
played back from a Web server. 


Rate 


Using a codec’s optimum sampling rate in your audio source file ensures 
that the audio stays synchronized with other media and prevents pitch 
shifting in audio resampling. Audio quality degrades if you use lower than 
the optimum sampling rate. If you use a higher sampling rate, it is best to 
use a multiple of the optimum rate. If the optimum rate is 8 kHz, for 
example, use a higher rate of 16 kHz or 32 kHz. 


Resp. 

This column lists the codec’s frequency response in kHz. A codec with a 
higher frequency response reproduces a wider range of sound than a codec 
with a lower response. A measure of codec quality, the frequency response 
does not affect how you produce audio. 


RealAudio Low Bandwidth Codecs 
RealAudio Codec G25 4 3 2 1 Rate Resp. | Comments 
5 Kbps Voice X |X |- |- |- |- |8kHz 4kHz_ | Lowest bit rate for speech or 
iL Tae with music. 


X |X |- I - |8kHz 4kHz_ | Low bit rate for speech or 
speech with music. 


- |- |- |- |- |8kHz 3kHz_ | Use with SureStream clips. 


6.5 Kbps Voice 


6 Kbps Music-G2 Mono 


< |) x< ~x< 


8 Kbps Voice X |X |X |8kHz 4kHz | Original voice codec. 
a3 Superseded by 8.5Kbps Voice. 
8 Kbps Music-G2 = X tet. 8 kHz 4kHz | Use with SureStream clips. 
8 Kbps Music |X 8 kHz 4kHz_ | DolbyNet codec. 
8.5 Kbps Voice Tx I 8 kHz High-quality voice codec for 


voice or voice with music. 


Use with SureStream clips. 


DolbyNet codec. 


11 Kbps Music-G2 Mono _ |X 5 as i 
12 Kbps Music 
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RealAudio Medium Bandwidth Codecs 


RealAudio Codec G25 4 3 2 1 Rate Resp. | Comments 

15.2 Kbps Voice X |X |X |X |X |- |8kHz 4kHz_ | Superseded by 16 Kbps Voice. 

16 Kbps Voice-Mono X x | -|- - - |16 kHz 7kHz_ | High-quality wideband for 
voice or voice with music. 

16 Kbps Music-G2 Mono |X |- |- |- |- |- |22.05kHz |8kHz_ | Use with SureStream clips. 

16 Kbps Music-Mono Low |X X x X |- |- |8kHz 4kHz | DolbyNet codec. 

Response 

16 Kbps Music-Mono X |X |X |X |- |- | 11.025 kHz] 4.7 kHz | DolbyNet codec for pop/rock 

Medium Response | L music. 

16 Kbps Music-Mono X |X |X |X |= |= | 11.025 kHz] 5.5 kHz | DolbyNet codec for classical 

High Response music. 

20 Kbps Music-G2 Mono Tx - Ir] - |- |- |22.05 kHz | 10 kHz | Use with SureStream clips. 

20 Kbps Music-G2 Mono |X |- |- |- |- |- |44.1 kHz | 17 kHz High frequency response. Use 

High Response | with SureStream clips. 

20 Kbps Music-G2 Stereo |X |- |- |- |- |- [ines kHz} 5 kHz | Use with SureStream clips. 


20 Kbps Music-Stereo 


RealAudio High Bandwidth Codecs 


DolbyNet codec. 


RealAudio Codec G25 4 3 2 1 Rate Resp. | Comments 

32 Kbps Voice-G2 Mono |X |- |- /~ |- |- |22.05 kHz | 11 kHz | Use with SureStream clips. 
32 Kbps Music-G2 Mono _ |X ie = - |- a - |44.1 kHz | 16 kHz Use with SureStream clips. 
32 Kbps Music-G2 Mono |X |- |- |- |- |- |44.1 kHz | 22 kHz | High frequency response. Use 
High Response maa | with SureStream clips. 

32 Kbps Music-G2 Stereo |X _ | - [7 |= [> [> [444 kHz [siz [Us with SureStream clips. 
32 Kbps Music-Mono X |X |X |- |- |- |16 kHz 8kHz | DolbyNet codec. 

52 Kbps Miusie-Stareo “| X oa “ [> [eons kHz 5.5 kHz | DolbyNet codec. 

40 Kbps Music-Mono Ix X [X |X - |- |22.05 a 11 kHz | DolbyNet codec. 

40 Kbps Music-Stereo X |X |X |X |- [- [16 kHz 8kHz_ | DolbyNet codec. 

44 Kbps Music-G2 Mono oan - |- |- |- |44.1 kHz | 20 kHz | Use with SureStream clips. 
44 Kbps Music-G2 Stereo |X = (= ieee ie (aed kHz | 11 kHz | Use with SureStream clips. 
64 Kbps Voice-G2 Mono |X |- |- |- |- |- |441 kHz _| 20 kr | Use with SureStream clips. 
64 Kbps Music-G2 Mono x | - oT - |- |44.1 kHz | 20 kHz | Use with SureStream clips. 


(Table Page 1 of 2) 
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RealAudio High Bandwidth Codecs (continued) 
RealAudio Codec G2 5 4 3 2 1 Rate Resp. Comments 
64 Kbps Music-G2 Stereo 
80 Kbps Music-Mono 
80 Kbps Music-Stereo 
96 Kbps Music-G2 Stereo |X 


Use with SureStream clips. 
DolbyNet codec. 
DolbyNet codec. 


20 kHz 
16 kHz 
24 kHz 


44.1 kHz Use with SureStream clips. 


(Table Page 2 of 2) 


Encoding RealAudio with RealSystem Tools 


When you encode RealAudio clips with a RealSystem G2 encoding tool, you 
simply set parameters such as audio type (voice or music) and compatibility 
with earlier versions of RealPlayer. You can also specify multiple bandwidth 
targets for the clip, such as both 28.8 Kbps modems and ISDN connections. 
The tool then chooses the best codec or codecs to use. The following sections 
give tips on using RealSystem tools. 


Additional Information 
See the tool’s manual or online help for step-by-step 
instructions on encoding RealAudio. RealSystem 
encoding tools are available for purchase or free 
download at http://www.real.com/products/tools/. 


Note 
Not all RealSystem tools may include the features 
described here. Check the product description or 
documentation for information on supported features. 


Retain Source Files 

Always keep a copy of the original audio source file. To edit the RealAudio clip 
or encode it with a different codec, modify the source file as necessary, then 
encode the file again as RealAudio. You cannot convert RealAudio clips to 
other audio formats. 


Using RealAudio in a MultiClip Presentation 

When you encode a RealAudio clip, consider whether it will play in parallel 
with another clip such as a RealPix. If you target 28.8 Kbps modems when 
encoding, for example, the tool may select a 20 Kbps codec, leaving no 
bandwidth for the second clip. Make sure you specify that the RealAudio clip 
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is just one part of the presentation. The tool then lets you choose a lower 
bandwidth codec, such as 8 or 12 Kbps. 


Multiple Encoding in a Single SureStream Clip 

You can create a single RealAudio clip encoded for up to six bandwidths with 
SureStream technology introduced in RealSystem G2. You can also specify 
backwards compatibility with earlier versions of RealPlayer. The encoding tool 
then encodes the clip for your selected bandwidths with the new RealAudio 
G2 codecs. It also includes in the clip an encoding that uses an older codec 
and targets the lowest bandwidth choice. 


For example, you can encode a single clip at 8, 16, and 32 Kbps using 
RealAudio G2 codecs. In the RealSystem encoding tool, you choose backwards 
compatibility to create an additional 8 Kbps stream with an older codec. 
Depending on its connection speed, RealPlayer G2 receives the 8, 16, or 32 
Kbps RealAudio G2 stream. Earlier versions of RealPlayer receive the 8 Kbps 
stream encoded with the older codec regardless of their connection speeds. 


Note 
To support multiple bandwidths with codecs other than 
RealAudio G2 codecs, you must encode a separate clip 
with each codec. You then use SMIL to specify 
bandwidth choices. For more on bandwidth selection 
through SMIL, see “Setting Bandwidth Choices” on 
page 90. 


Batch Encoding 

Your encoding tool may have a batch mode that lets you encode several clips at 
once. The batch encoder may run through a command-line interface or a 
graphical user interface. 


Streaming Other Audio Formats 


RealSystem can stream several audio formats in addition to RealAudio. The 
following table lists the streamable formats and shows whether RealPlayer G2 
for different operating systems (Windows 95 or NT, Macintosh, and UNIX) 
can play the audio. RealSystem typically does not stream audio formats that 
have been compressed with a codec. Where codec compression is supported, 


49 


CHAPTER 4: Producing Audio RealSystem G2 Production Guide 


codecs are not included with RealPlayer G2 and must reside on the playback 
machine already. 
Streamable Audio Formats 
Format Codec compression Win32 Mac UNIX 


AIFF | uncompressed yes |yes_ |yes 


(aif) | 
AU uncompressed yes yes “|yee 


Note 
RealSystem plug-ins may exist for additional audio 


formats. Check http://www.real.com/devzone for 
information about other audio formats you can stream. 


Tips for Streaming other Audio Formats 
Observe the following points when streaming audio formats other than 


RealAudio: 


- Test whether a codec-compressed audio clip plays in RealPlayer by copying 
the clip to each platform and opening it locally with RealPlayer. 


- A-law compression is not supported for the AU format. It is supported for 
WAV, however. 


- Most uncompressed WAV files work on Macintosh and Unix. Some may 
not, however. Before streaming an uncompressed WAV file, test playback 
locally by opening the file with RealPlayer G2 on these platforms. 


+ The audio formats listed above may not work for low bandwidth 
connections. Test bandwidth consumption by opening the file in 
RealPlayer G2 and watching the status panel, which will list the streaming 
bit rate. If the rate is too high, convert the file to RealAudio. 
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PRODUCING VIDEO 


RealNetworks introduced RealVideo with RealSystem 4.0, making 
streaming video available over the Internet. This chapter covers 
RealVideo production and explains other video formats that 
RealSystem G2 can stream. It also provides tips for capturing high- 
quality video and working with digitized video source files. 


Steps for Streaming RealVideo 


When producing a RealVideo clip, you should choose the best source material 
and best equipment possible. The goal throughout the video production 
process is to get the best video quality with the smallest streaming file size. 


Creating RealVideo Clips 


1. Record Video 2. Digitize Video 
/\ 


3. Encode RealVideo 


G-™ &.c 


RealVideo Clip Real Video 
Encoder RealVideo RealPlayer 
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> The following steps summarize how to create a RealVideo clip: 


1. Capture video. 


To start video production, you capture video source by shooting a scene 
with a video camera, for example, or gathering prerecorded content from 
tape, satellite, laserdisc, or so on. 


Additional Information 
“Recording Video” on page 53 provides guidelines for 
shooting a video. 


. Digitize and edit video. 


You next digitize the video to a standard file format, such as AVI or 
QuickTime. With your preferred video editing software, you can then edit 
the video as necessary. If you are broadcasting live, however, you encode 
the streaming video directly from the source. 


Additional Information 
See “Digitizing Video” on page 54 for tips on video 
editing. For more on live broadcasting, read Chapter 11, 
starting on page 159. 


. Encode RealVideo clip. 


With your digitized file optimized or your live broadcast ready to go, you 
encode your source as RealVideo. When you do this, you target a network 
bandwidth or set of bandwidths, and choose a RealAudio codec or set of 
codecs for the audio track. 


Additional Information 
See “Creating RealVideo Clips” on page 57 for more on 
RealVideo production. “Choosing RealAudio Codecs” 
on page 45 explains RealAudio codecs. 


. Deliver RealVideo clip. 


With your presentation ready to go, you make your RealVideo clip or 
broadcast available through your Website. If you are combining video with 
another streaming clip, you write a SMIL file that assembles the pieces. 


Additional Information 
Chapter 7 starting on page 75 explains how to create a 
SMIL file. See Chapter 10 beginning on page 145 for 
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instructions on linking your Web page to a RealVideo 
clip or a SMIL file. 


Recording Video 


Observe the following points if you intend to shoot a new video rather than 
use existing video content. Because video loses image quality when 
compressed for streaming, always start with the best video source available. 


Additional Information 
For pointers on recording audio, see “Capturing Audio” 
on page 41. 


Use a High-Quality Source Format 

Whether you shoot a video yourself or digitize existing material, it’s important 
to start with a high-quality video format. The following are common 
videotape formats in order of descending quality: 


1. Betacam SP, also known simply as Beta. This format is common among 
video production professionals. 


2. DV, miniDV, DVCam, or DVCPro. 
3. Super-VHS (S-VHS) or HI-8mm. 
4. VHS, 8mm. 


Stage According to the Video’s Final Size 

It’s important to consider the video’s final frame size before you shoot the 
first frame. Reaching Web users with 28.8 Kbps modems requires a video 
window approximately 176x132 pixels. With this small size, you need to frame 
important visual elements well. 


Additional Information 
For more on window size, see “Digitizing Video” on 
page 54. 


Minimize Scene Changes and Movement 

The less that changes from frame to frame, the sharper the image will appear 
in the encoded video. RealVideo compression technology reuses existing data 
when frames are similar, so a video with relatively stationary subjects (“talking 
heads”) will look better than a music video with rapid scene changes and a lot 
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of movement. You can do the following to cut down on unnecessary 
movement: 


- Use a mounted rather than hand-held camera. This greatly reduces the 
movement you inadvertently introduce into the scene when recording. 


+ Don’t have a rapidly moving object fill the entire frame. Keep in mind, 
though, that your streaming video may be a few square inches in size, so 
you don’t want to pull the camera back too far. 


Of course, you don’t want to eliminate all dynamic elements! When you do 
include rapid movement, give enough time for objects to resolve. Because of 
low frame rates and high compression, objects coming to rest may appear 
blurry at first. If you have a dialog box popping up on a computer screen, for 
example, show that box stationary for a few seconds so that the image resolves. 


Tip 
RealPix makes a great companion to RealVideo. When 
presenting a lecture, for example, use RealVideo to show 
the speaker and a RealPix slideshow to present visual 
aids such as information written on a blackboard. For 
more on RealPix, see “Images” on page 12. 


Use Uniform Colors and Good Lighting 

Bright lighting at a constant exposure keeps the foreground detail crisp. Use 
uniform, dark colors for backgrounds, and uniform, light colors (but not 
whites) for clothing. Complex textures such as paisley and stripes degrade the 
final image quality with unwanted visual effects. 


Digitizing Video 


If you are not broadcasting RealVideo live, you digitize the source video (direct 
camera feed, tape, disc, or so on) on your computer or video editing station. 
You can then edit the file with your preferred video editing software before 
encoding it as RealVideo. The following sections provide tips for digitizing 
video. 


Capture at 30 or 15 Frames per Second (fps) 

Capture video at 15 or, for high-bandwidth streaming, 30 fps. RealVideo 
encoding tools use a frame rate that varies with the bandwidth target and the 
emphasis on smooth motion or image quality. RealVideo’s Scalable Video 
Technology (SVT) also allows RealVideo clips to vary in frame rate from 30 fps 
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to S fps based on the RealPlayer computer’s processor speed. This means you 
can produce high frame rate RealVideo clips that do not overburden the 
processors of slow machines during playback. 


Use 24-bit Color Depth 
Always use 24-bit color. Lower color resolution produces poor quality videos. 


Use S-video Output 
Video playback devices commonly have at least two common output types, S- 
video and composite. Use S-video, which produces better results. 


Use a Fast Machine 

Video capture places a large burden on a computer’s CPU and hard drive. Be 
sure to have a fast machine. To avoid dropping frames during video capture, 
use a hard drive specially made for audio and video work. On Windows 
machines, you can use any video capture card that supports Video for 
Windows. 


Capture at a 320x240 Pixel Window Size 

Unless you are short on disk space or your video capture card recommends a 
different window size, capture video in a window 320 pixels wide by 240 pixels 
high. With your video editing software or RealVideo encoding tool, you can 
then reduce the window size if necessary before encoding the RealVideo clip. 


The following table, which you should use as a general guideline only, shows 
three common RealVideo clip sizes that maintain the 4:3 aspect ratio used in 
television. You can produce RealVideo at any width-to-height ratio, however. 


RealVideo Size and Bandwidth Guidelines at 10-15 fps 
Width x Height Pixel Size RealVideo Bandwidth Image Quality 


176 x 132 20-500 Kbps Good to High 
240 x 180 100-500 Kbps High 
320 x 240 200-S00 Kbps High 


For each window size, the table lists bandwidth guidelines that assume a 
desired frame rate of 10 to 15 fps. The table shows that for 28.8 Kbps modems 
(20 Kbps usable bandwidth), you should use a window no larger than 
176x132. Although its overall quality will be good, the image may encode at 
less than 10 fps. You'll get better quality when encoding for higher 
bandwidths. 
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Keep in mind that you can create a 240x180 window for bandwidths lower 
than 100 Kbps, or a 320x240 video for bandwidths lower than 200Kbps. But 
you're not likely to get high image resolution and 10-15 fps. The video might 
encode at 5-7 fps, for example, which may be acceptable for your audience. 
Experiment with different sizes, playing the encoded clip back in RealPlayer 
G2 to test its quality. 


Tip 
With your RealVideo encoding tool, you can choose to 
encode a large video for low bandwidths as a “slide 
show,” which streams approximately one frame per 
second. 


Additional Information 
See Chapter 3 beginning on page 27 for details on 
targeting bandwidth. 


Digitize in AVI on Windows or QuickTime on Macintosh 

It is better to work with uncompressed formats. Otherwise, you compress the 
source once when you digitize it and again when you encode it as RealVideo. 
This double compression can decrease the image quality. Use a compressed 
source format only if your RealVideo encoding tool supports the file as input. 
You can use compressed AVI as long as the RealVideo encoding machine has 
the same Video for Windows (VFW) driver used to compress the AVI. 


Additional Information 
For more on RealVideo input formats, see “Creating 
RealVideo Clips” on page 57. 


Ensure Enough Disk Space for Digitized Video 
Use this formula to calculate the approximate size in Megabytes of a digitized 
video file: 


(pixel width) x (pixel height) x (color bit depth) x (fps) x (duration in seconds) 
PS a ARI psi A i ra IN CS Aa 
8,000,000 


Suppose you want to capture a three minute video at 15 frames per second 
with 24-bit color in a window that is 320x240 pixels. Your digitized source file 
would be approximately 622 Megabytes: 


(320) x (240) x (24) x (15) x (180) / 8,000,000 = 622 Megabytes 
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If necessary, you can conserve disk space by decreasing the window size or 
lowering the frame rate. 


Tip 
Windows 9S and Macintosh operating systems limit a 
single video file to 2 Gigabytes (2048 Megabytes). At a 
320x240 window size and 15 fps, this translates to about 
9.5 minutes of video. To work around this, create 
separate source files, encode them as separate RealVideo 
clips, and merge the clips with editing tools included 
with your RealVideo production software. 


Creating RealVideo Clips 


RealVideo’s high compression rate makes it well-suited for streaming video 
over the Internet or intranets. A RealVideo clip uses the file extension .rm and 
typically includes an embedded soundtrack encoded as RealAudio. You start 
with a video file in a digitized format, then encode a RealVideo clip from this 
source file using a RealVideo encoding tool. Your encoding tool should be able 
to accept at least one of these input formats: 


» AVI (.avi), uncompressed (recommended) or compressed 

* MPEG-1 (.mpg) 

* QuickTime 2.0 (.mov), uncompressed (recommended) or compressed 
Additional Information 


RealVideo production tools are available at 


http://www.real.com/products/tools/. 


Choosing RealVideo Codecs 


Like RealAudio, RealVideo uses a “lossy” compression scheme that discards 
parts of the source file during encoding. The following table provides a 
reference for RealVideo codecs. An “xX” in the G2, 5, or 4 column indicates that 
a clip encoded with this codec can be played by RealPlayer G2, 5.0, or 4.0. 
Earlier versions of RealPlayer do not play RealVideo. 
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RealVideo Codecs 

RealVideo Codec G2 5 4 Comments 
Oe 

RealVideo G2 with |X |- |- | All features of RealVideo G2 codec, plus Scalable 

SVT (new default) Video Technology (SVT) to scale frame rates for 

| different connection speeds. 
RealVideo G2 (old Ix |- |- | Use for fast encoding and encoding a single clip for 
default) | multiple bandwidths using SureStream. 
7 
Standard X |X |X | Standard codec for past releases. No multiple 
|_| encoding in a single clip. 

Fractal [x |x |x | Discontinued in RealSystem G2 encoders. RealPlayer 

(discontinued) G2 can play existing fractal-encoded clips, though. 
———————————— ae 


Encoding RealVideo with RealSystem Tools 


When you encode RealVideo, you choose an overall bandwidth target or set of 
targets, then set parameters such as audio type (voice or music), compatibility 
with earlier versions of RealPlayer, and an emphasis on smooth motion or 
sharp images. After you make your choices, the encoding tool chooses the 
audio codec or codecs to use and encodes the clip using a variable frame rate. 
The following sections give tips on using RealSystem production tools. 


Additional Information 
See the tool’s manual or online help for step-by-step 
instructions on encoding RealVideo, as well as more 
information about encoding options. RealVideo 
production tools are available for purchase or free 
download at http://www.real.com/products/tools/. 


Note 
Not all RealSystem tools may include the features 
described here. Check the product description or 
documentation for information on supported features. 


Retain Source Files 

Always keep a copy of the original video source file. To edit the RealVideo clip, 
modify the source file as necessary, then encode the file again as RealVideo. 
You cannot convert RealVideo clips to other video formats. 
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Using RealVideo in a MultiClip Presentation 

When you encode a RealVideo clip, consider whether it will play in parallel 
with another clip. If so, you can set an option in your encoding tool so that the 
RealVideo clip does not consume all available bandwidth. For a 28.8 Kbps 
modem connection, for example, the encoder standardly encodes the clip to 
use 20 Kbps. You can alter this default value so that the video uses 12 Kbps, 
for example, leaving bandwidth free for another clip. 


Additional Information 
Chapter 3 beginning on page 27 explains more about 
target bandwidths. 


Multiple Encoding in a Single SureStream Clip 

You can create a single RealVideo clip encoded for up to six bandwidths with 
RealSystem’s SureStream technology, which uses the RealSystem G2 video 
and audio codecs. You can also specify backwards compatibility with 
RealPlayer 5.0. The encoding tool then encodes the clip for your selected 
bandwidths with the RealVideo and RealAudio G2 codecs. It also includes in 
the clip an encoding that uses a codec compatible with RealPlayer 5.0 and 
targets the lowest bandwidth choice. 


For example, you can encode a single clip for the target connections shown in 
the table below. Based on its connection speed, RealPlayer G2 receives the 
SureStream 20, 32, 45, or 80 Kbps stream. Earlier versions of RealPlayer receive 
the 20 Kbps backwards-compatible stream regardless of their connection 
speeds. Note that the RealAudio codec choices shown below are examples only. 
The encoding tool may choose other codecs depending on a voice or music 
soundtrack, and which features of the video you want to emphasize. 


RealVideo SureStream Clip Example 


RealVideo 
Target Connection Clip Bit Rate RealAudio Codec Bandwidth 
28.8 Kbps modem 20 Kbps 8 Kbps Music 12 Kbps 
(backwards compatible) | 
28.8 Kbps modem 20 Kbps 8 Kbps Music-G2 Mono _ | 12 Kbps 
56.0 Kbps modem 32 Kbps 11 Kbps Music-G2 Mono | 21 Kbps 
56.0 Kbps ISDN | 45 Kbps | 20 Kbps Music-G2 Stereo | 25 Kbps 
112 Kbps dual ISDN 80 Kbps 44 Kbps Music-G2 Stereo | 36 Kbps 
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Additional Information 
For information on RealAudio codecs, see “Choosing 
RealAudio Codecs” on page 4S. 


Note 
To support multiple bandwidths without using 
SureStream and the new RealSystem G2 codecs, you 
must encode a separate clip with each codec. You then 
use a SMIL file to specify bandwidth choices. For more 
on bandwidth selection through SMIL, see “Setting 
Bandwidth Choices” on page 90. 


Scaling Frame Rates with SVT 

RealVideo’s Scalable Video Technology (SVT) lets you encode a single, large 
RealVideo clip at a high frame rate, such as 30 frames per second. This gives 
viewers with fast machines and high bandwidth connections the best video 
quality possible. For viewers with slower machines, SVT automatically reduces 
the clip’s frame rate to an optimal level. For example, SVT can smoothly scale 
down a RealVideo clip encoded at 30 fps to a minimum of S fps. 


Tip 
If you do not use the RealVideo G2 SVT codec, 
RealVideo clips encoded for 200 Kbps or higher 
bandwidths may have image quality and frame rates 
that overburden processors slower than 120 Mhz. 


Video Window Cropping 

When you encode with the new RealVideo standard codec, the encoding tool 
crops the video window to multiples of 4 pixels, so a 176x132 video stays its 
original size. With the older standard codec, the tool crops to multiples of 16 
pixels, however, so a 176x132 video encodes at 176x128 pixels. Some encoding 
tools also let you manually crop or resize the video. 


Batch Encoding 

Your encoding tool may have a batch mode that lets you encode several clips at 
once. The batch encoder may run through a command-line interface or a 
graphical user interface. 


60 


RealSystem G2 Production Guide CHAPTER 5: Producing Video 


Streaming Other Video Formats 


RealSystem can stream several video formats in addition to RealVideo. The 
following table lists the streamable formats and shows whether RealPlayer G2 
for different operating systems (Windows 95 or NT, Macintosh, and UNIX) 
can play back the video. RealSystem supports all Vivo codecs. For other video 
formats, however, it typically does not stream codec-compressed files. When 
codec compression other than Vivo is supported, codecs are not included with 
RealPlayer G2 and must reside on the playback machine already. 


Streamable Video Formats 


Format Codec compression Win32 Mac UNIX 

compressed yes no no 
ASF 1.0 (.asf) 

uncompressed yes yes | yes 

a! 
: compressed yes no | no 

AVI 1.0 (.avi) 

uncompressed yes jyes_ |yes 
QuickTime 2.0 | compressed yes |no no 
(.mov) uncompressed yes yes |yes 
Vivo (.viv) compressed 


Note 


RealSystem plug-ins may exist for other video formats. 
Check http://www.real.com/devzone for information 
about additional video formats you can stream. 


Tips for Streaming other Video Formats 
Observe the following points when streaming video formats other than 
RealVideo: 


- Test whether a codec-compressed video clip plays in RealPlayer by copying 
the clip to each platform and opening it locally with RealPlayer. 


+ For the ASF and QuickTime formats, RealSystem ignores any tracks other 
than video or audio. It disregards scripting commands, for example. 


- For QuickTime 2.0 on Windows, RealPlayer G2 supports CVID, Cinepak, 
and Indeo codec compression, provided those codecs are installed on the 
machine already. 


+ Because other video formats may not be as highly compressed as 
RealVideo, they may not be good for low bandwidth connections. Test 
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bandwidth needs by opening the file in RealPlayer G2 and watching the 
RealPlayer status panel, which will list the streaming bit rate. If the rate is 
too high for your target audience, use RealVideo instead. 


- For high-bandwidth connections or videos that play back from a uset’s 
local disk, CPU power is a consideration. Play the file in RealPlayer G2 and 
monitor CPU use with the tool of your choice. Decide whether an 
“average” machine for your target audience can handle the load. If CPU 
use is too high, convert the video to a high-bandwidth RealVideo clip. 
This creates a high-quality video with a lower CPU requirement. 
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RealFlash makes it easy to put animation on the World Wide Web. 


PRODUCING ANIMATION 


Combining the power of Macromedia Flash with the clarity of 
RealNetworks’ RealAudio, RealFlash produces visually arresting 
animations with superb sound. This chapter explains how to create 
RealFlash content for different bandwidths. It also provides tips for 
optimizing RealFlash clips. 


Additional Information 
For exciting examples of streaming animation, visit 
http://www.real.com/showcase/animation/. For 
instructions about using Macromedia Flash, refer to 
Macromedia documentation. Find more information at 
http://www.macromedia.com/software/flash/. 


Preparing a RealFlash Clip 


RealFlash is well-suited for linear presentations that have continuous audio 
and images synchronized along a timeline, including: 


+ full-length, television-like cartoons for entertainment and education, 


+ Internet or intranet demonstrations, training courses, and product 
overviews, 


+ product advertisements, 
* movie trailers, 
+ and Karaoke. 


A RealFlash clip consists of two separate files streamed in parallel: a 
Shockwave Flash animation file and a RealAudio soundtrack. To create these 
components, you develop animation in Macromedia Flash and synchronize it 
with an imported sound file, such as a WAV or AIFF file. You then export a 
Shockwave Flash file that contains the animation, and generate a RealAudio 
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file from the soundtrack. RealServer streams the clip to RealPlayer, ensuring 
that animation and sound stay synchronized. 


RealFlash Clips Consist of Shockwave Flash and RealAudio 


Shockwave 
FE Clip RealServer RealPlayer 


Presentation 
Streams 


RealAudio 
Clip 


Tip 
Macromedia Flash provides different methods for 
incorporating sound into an animation. For RealFlash 
clips, use the stream synchronization setting. 


Note 
RealPlayer G2 supports Macromedia Flash 2.0 features. 
It does not support most features introduced in Flash 
3.0, such as alpha channels and transparency. Morphing 
(“shape tweening”) is supported but should be used 
sparingly to keep the streaming file size low. 


Choosing a Target Bandwidth 


When you begin to develop your RealFlash clip, target an audience connection 
speed and create content with that bandwidth in mind. This helps ensure that 
both the Shockwave Flash animation and the RealAudio clip stream smoothly. 
If your target bit rate is 28.8 Kbps, for example, you have approximately 20 
Kbps of bandwidth to divide between the RealAudio soundtrack stream and 
the Shockwave Flash animation stream. 


Additional Information 
For an overview of bandwidth considerations, see 


Chapter 3 beginning on page 27. 
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The good news is that designing Realflash content for a low bandwidth does 
not diminish the quality of the animation. RealFlash transmits vector 
information that the viewer's machine then renders. So unlike bitmap 
animations, Flash animation depends more on the machine's CPU and 
graphics capabilities than the amount of data downloaded. A well-designed 
28.8 Kbps RealFlash animation can have the same visual impact as an 


animation requiring a significantly higher connection speed. 


Dividing Bandwidth Between Shockwave Flash and RealAudio 


Once you have determined the combined bit rate for Shockwave Flash and 
RealAudio, you need to divide the rate between the Shockwave Flash and 
RealAudio components. Your animation usually determines this division 


because it typically consumes more bandwidth. Although you may not have a 
final bandwidth figure until you create, export, and tune your animation, you 
should start with a target estimate. The table below lists possible RealAudio 
and Shockwave Flash bit rate combinations for a 28.8 Kbps connection (20 


Kbps usable). 


Recommended Bandwidth Divisions between RealAudio and Flash at 20Kbps 


Presentation Type 


RealAudio 


Shockwave Flash 


Emphasis on animation with good quality 
spoken soundtrack for RealPlayer G2 and 5.0 


5 Kbps Voice 


15 Kbps 


Emphasis on animation with better quality | 6.5 Kbps Voice | 13.5 Kbps 
spoken soundtrack for RealPlayer G2 and 5.0 

Emphasis on animation with high quality 8.5 Kbps Voice 11.5 Kbps 
spoken soundtrack for RealPlayer G2 and 5.0 

Emphasis on animation with good quality 8 Kbps Music 12 Kbps 
music soundtrack for RealPlayer G2 and 5.0 

Emphasis on animation with good quality 6 Kbps Music- 14 Kbps 
music soundtrack for RealPlayer G2 only G2 Mono 

Emphasis on animation with higher quality | 8 Kbps Music- 12 Kbps 
music soundtrack for RealPlayer G2 only [ee Mono 

Emphasis on high quality music soundtrack | 11 Kbps Music- | 9 Kbps 


with animation for RealPlayer G2 only 


G2 Mono 


Additional Information 


See “Choosing RealAudio Codecs” on page 45 for a full 


list of codecs. 
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Tips for Choosing RealAudio Codecs 
Here are some tips for selecting a RealAudio codec: 


- Because RealAudio bandwidth consumption is flat, a soundtrack using an 
8.5 Kbps codec, for example, will consistently consume 8.5 Kbps of 
bandwidth. The remainder of the combined bandwidth is available for 
Shockwave Flash. 


- If sound quality takes precedence, start by selecting the RealAudio codec 
that supplies high-quality audio while leaving enough bandwidth for 
acceptable animation. 


» When animation is complex, use low bit rate RealAudio codecs targeted 
for voice. This increases the bandwidth available for complex animation. 


+ The lowest bit rate for a RealSystem G2 music codec is 6 Kbps. The lowest 
bit rate for a music codec playable by RealPlayer G2 and RealPlayer S.0 is 8 
Kbps. 


- With SureStream technology and the RealSystem G2 codecs, you can 
encode a single RealAudio file for multiple bandwidths. RealPlayer G2 
then selects the bandwidth encoding appropriate to its connection speed. 


Additional Information 
For the basics of SureStream, read “Using SureStream 
Clips for Multiple Bandwidths” on page 3S. 


Adding RealPlayer 5.0 Compatibility 


RealPlayer G2 and RealPlayer 5.0 can both play RealFlash presentations, but 
RealPlayer 5.0 does not support all the options available with RealPlayer G2: 


- RealFlash for RealPlayer 5.0 supports only Flash 2.0 features. 


+ RealPlayer 5.0 cannot read SMIL files or play a presentation that includes 
RealPix or RealText. 


+ RealPlayer 5.0 cannot play soundtracks encoded with RealAudio G2 
codecs. 


To support RealPlayer 5.0 along with RealPlayer G2, avoid using Flash 3.0 
features and use any of the following methods when encoding the soundtrack 
as RealAudio: 
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1. Create a RealAudio SureStream clip that uses RealAudio G2 codecs for 
one or more bandwidths. When encoding, choose the backwards- 
compatibility option to create an encoding for RealPlayer 5.0. 


Additional Information 
For more on SureStream and RealPlayer 5.0 
compatibility, see “Multiple Encoding in a Single 
SureStream Clip” on page 49. 


2. Create two separate encodings of the soundtrack: one that uses 
RealSystem G2 codecs and one that uses a codec playable by RealPlayer 
5.0. 


3. Create one soundtrack using a RealAudio 5.0 codec. This option does not 
deliver the highest-quality sound to RealPlayer G2 users, however. 


Additional Information 
For information about creating Web page links to these 
types of presentations, see “Supporting RealPlayer 5.0” 
on page 73. 


Maximizing Flash Efficiency 


Unlike RealAudio, Shockwave Flash does not consume bandwidth at an even 
rate. This is the nature of vector-based animation. At the start of a scene, for 
example, groups and symbols for the scene are streamed. This requires a lot of 
data transfer. After that, only “lightweight” instructions for manipulating 
groups and symbols are needed. This process results in bandwidth 
consumption like that shown in the following figure. 
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Shockwave Flash Sample Bit Rate Requirement 
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This graph shows a sample Shockwave Flash clip that targets a bandwidth of 
12 Kbps. At five and ten seconds into the clip, the bandwidth requirement 
spikes because the clip requires more than 12 Kb of data. These spikes 
typically correspond to scene changes or the introduction of new objects in a 
key frame. RealPlayer responds by buffering the data as it comes in, potentially 
delaying playback until all necessary data has arrived. 


As you create your Macromedia Flash animation, you need to minimize the 
spikes that may cause RealPlayer to halt the presentation while it buffers data. 
There are two ways you can do this: 


1. As you create your animation, minimize the overall bit rate requirement of 
the Shockwave Flash stream by keeping the ratio of file size to clip length 
as low as possible. This doesn't eliminate spikes, but it helps keep the 
spikes smaller. The guidelines below explain how to do this. 


2. After you export your animation file, use the Shockwave Flash tuning 
utility to change the streaming file's bandwidth consumption. You can 
also use the RealFlash Bit Rate Calculation Spreadsheet to view frame-by- 
frame bandwidth needs. 


Additional Information 
“Tuning Shockwave Flash” on page 72. 


Keeping Shockwave Flash Files Small 


The following are recommendations for keeping Shockwave Flash file size 
down as you develop the animation: 
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Reduce key frames. 


Excessive key frame changes increase bandwidth consumption. Minimize 
the number of key frames and simplify the objects within key frames. 


Use symbols instead of groups. 


Flash stores a symbol once and can refer to it repeatedly, each reference 
adding little to the file size. However, it stores a group definition each 
time the group is used. Using a group three times, for example, stores the 
same data in the file three times. Using symbols instead of groups can 
therefore reduce file size significantly. 


Minimize morphing. 
The Macromedia Flash 3.0 morphing feature (“shape tweening”) creates 


additional key frames and hence increases the file size and streaming bit 
rate. 


Simplify elements. 


Simplify the elements drawn in or imported into Macromedia Flash. 
Under Modify>Curves, use the Smooth and Straighten commands on lines 
and curves to strip away unneeded point and path information. This 
reduces the data stored for each element. Use Optimize to optimize the 
data reduction while maintaining acceptable screen appearance. Because 
screen resolution is lower than print resolution, you can eliminate minute 
details without compromising appearance. 


Adjust JPEG quality when exporting. 


When exporting .fla files to .swf files, set the JPEG quality to no greater 
than SO, possibly as low as 30. 


Minimizing CPU Usage 


Bandwidth is not the only consideration when optimizing files. Macromedia 
Flash's vector-based animation differs from raster or bitmap animation in 


that the user's machine must perform complex calculations to display the 


animation. Operations that require many calculations on top of the normal 
load may adversely affect playback. The following are ways to reduce RealFlash 


CPU requirements: 


Set a frame rate of seven (7) fps for 28.8 Kbps connections. This provides 
acceptably smooth motion without overburdening most processors. 
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+ Optimize tweening. 


Tweening interpolates the motion between key frames. Interpolating 
multiple objects and color effects at the same time will adversely affect 
playback. Other actions related to tweening that slow down playback are 
changing large areas of the screen between frames and using gradient fills. 


Decrease the number and size of objects simultaneously moving on 
screen. 


RealPlayer must redraw areas where action occurs, thus consuming CPU 
cycles. To minimize this, localize tweening to a small portion of the screen 
so that the entire screen does not have to be redrawn. File size remains the 
same, but only one part of the screen is redrawn. 


Using Interactive Commands 


Although RealFlash is best suited for linear presentations, you can add 
interactivity through the Shockwave commands listed below. RealFlash maps 
these commands to RealPlayer functions. At the end of your RealFlash clip, for 
example, you might have a graphic that says, “Click here to visit our home 
page.” The Shockwave Get URL command used with this graphic corresponds 
to an internal RealPlayer command that displays the URL in the browser 
window. 


Shockwave and RealPlayer Interactive Commands 


Shockwave _ RealPlayer 
Command Mapping Action 


Play _| Play Playback begins or resumes. 

Stop Pause Clip pauses until action is performed or the Play button 
is pressed. 

Goto Seek and_ | RealPlayer seeks to the designated frame, buffers the 

Pause clip preroll, and pauses. 

Goto and |Seek and _ | RealPlayer seeks to the designated frame, buffers the 

Play Play clip preroll, and begins playback. 

Get URL (internal) | Displays URL in browser window. Because the user has 
to return to RealFlash manually, use this only at the end 
of a clip. 


ra a SRC SE LARNER RRS DD PO RE RET SEM SNPS AAR Th SETS DE ES 
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Tip 
Because seeking requires buffering, do not use Goto 
commands to advance from one scene to the next. When 
you export your animation to Shockwave Flash, scenes 
are concatenated so that the animation flows from one 
scene to the next. 


Additional Information 
A SMIL file can define clickable hyperlinks for the 
presentation. See “Linking to Other Media” on page 
104. 


Creating a RealFlash Clip 


The following sections explain the steps for creating a RealFlash clip once you 
finish developing your animation in Macromedia Flash. Refer to the manuals 
for the tools you use for step-by-step instructions on carrying out each task. 


Exporting Shockwave Flash 


You export your animation to a Shockwave Flash 2.0 file (.swf) for use with 
RealSystem. This creates a compressed version of the animation suitable for 
streaming. When you export the Shockwave Flash file, you disable the audio 
stream. You later export the soundtrack separately and convert it to 
RealAudio. Here are tips on exporting Shockwave Flash: 


+ Set JPEG quality between 30 and SO. This helps to keep the file size down. 


- Click the Generate Size Report checkbox. This creates a movie report you 
can use with the tuning spreadsheet. RealNetworks recommends that you 
use the movie report and spreadsheet to evaluate your RealFlash clip for 
bandwidth efficiency. 


The ratio of Shockwave file size to clip length is a good indication of the 
overall bandwidth requirement. Convert the file size to Kilobits and divide by 
the number of seconds in the animation to get the average bandwidth. This 
number should be below your allowable bit rate for Shockwave Flash. For 
example, to find the average bandwidth of a 325 Kilobyte file that plays for 3 
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minutes, multiply 325 by 8 to get 2624 Kilobits. Then divide by 180 seconds to 
get an average bandwidth of 14.6 Kbps. 


Converting File Size to Kilobits 


Using This Measurement Do This to Get Kilobits 
Megabytes Multiply by 8192 
Kilobytes Multiply by 8 
bytes : Divide by 128 
bits Divide by 1024 

Tip 


You can also find the average bit rate of a Shockwave 
Flash file by dropping it onto RealPlayer G2 and 
observing the RealPlayer status bar. 


Keep in mind that even a clip with an acceptable average bandwidth may stall 
during playback because it contains bandwidth spikes. The spreadsheet 
indicates where spikes occur. 


Tuning Shockwave Flash 


After you generate a Shockwave Flash file and create the movie report, you 
must use the RealFlash Bandwidth Tuner to view bandwidth statistics and 
adjust the file's streaming bit rate. You can also use the RealFlash Bit Rate 
Calculation Spreadsheet to examine the file's bandwidth consumption frame- 
by-frame. You will need Microsoft Word and Microsoft Excel to use the 
spreadsheet. See the tuner online help for instructions on using the tuner and 
spreadsheet. 


Note 
These tools are included in the RealSystem G2 
Authoring Kit, available through registration at 
http://www.real.com/products/tools/authkit/index. 
html. 


Exporting Audio 


After you have created and tuned your Shockwave Flash file, export the movie 
soundtrack as a Windows AVI or Macintosh QuickTime file, setting 32x21 as 
the height and width attributes to minimize disk space use. Next, encode the 
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AVI or QuickTime soundtrack in the RealAudio format with a RealNetworks 
encoding tool, using the file extension .rm. 


Additional Information 
For more on audio production, see Chapter 4 beginning 
on page 39. For codec considerations in RealFlash, see 
“Dividing Bandwidth Between Shockwave Flash and 
RealAudio” on page 65. 


Delivering the RealFlash Presentation 


When your Shockwave Flash and RealAudio files are complete, you create a 
SMIL file that lists the URLs for these files. Chapter 7 beginning on page 75 
explains how to create the SMIL file. In its simplest form, the SMIL file 
specifies that the two files play in parallel: 
<smil> 
<body> 
<par> 
<audio src="rtsp://realserver.company.com:554/media/sound.rm”/> 
<animation src="rtsp://realserver.company.com:554/media/cartoon.swf”/> 


</par> 
</body> 
</smil> 


You can also use the SMIL file to define clickable hypertext links, create 
timing offsets between the clips, or add presentation information such as title, 
author, and copyright. Next, move the Shockwave Flash, RealAudio, and SMIL 
files to RealServer and link your Web page to the SMIL file. 


Additional Information 
For instructions on linking Web pages to clips on 
RealServer, see “Streaming Clips from RealServer G2” 
on page 146. 


Supporting RealPlayer 5.0 


As described in “Adding RealPlayer 5.0 Compatibility” on page 66, you can 
support RealPlayer 5.0 in a number of ways. The simplest means of delivering 
a 5.0-compatible presentation through a single URL is to create a SMIL file for 
RealPlayer G2 as described above. Then create a Ram file (extension .ram) that 
looks like this: 
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rtsp://realserver.company.com:554/media/animation.smil 
--stop-- 
pnm://realserver.company.com:7070/media/cartoon.swf+sound.rm 


You next link your Web page to this Ram file with a standard HTTP hypertext 
link. Users with RealServer G2 receive the SMIL-based presentation. Those 
with RealPlayer 5.0 receive the presentation defined below the --stop-- marker. 
Note that this second link uses the older PNA protocol and associates the 
animation and soundtrack through the “+” operator. 
Additional Information 

See “Creating a Ram File Manually” on page 153. To 

embed the presentation in a Web page, see Chapter 8 

beginning on page 117. 


Note 
In the examples above, the same soundtrack (sound.rm) 
is used for both RealPlayer 5.0 and RealPlayer G2. This 
works if the soundtrack uses a RealAudio 5.0 codec or is 
a RealAudio G2 SureStream clip with the 5.0 backwards- 
compatibility option. 
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ASSEMBLING A PRESENTATION WITH 
SMIL 


When your multimedia presentation contains multiple clips—such 
as a slideshow and a video played together—you use Synchronized 
Multimedia Integration Language (SMIL) to coordinate the parts. 
Pronounced “smile,” SMIL uses a simple but powerful mark-up 
language for specifying how and when clips play. After writing the 
SMIL file, you put it on RealServer and link your Web page to it as 
described in Chapter 10, beginning on page 145. 


Tip 
If you have just one clip in your presentation, such as a 
single RealVideo clip, you don’t need to create a SMIL 
file. Just link your Web page to the media clip as 
explained in Chapter 10. 


Additional Information 
Once you are familiar with SMIL, refer to “Appendix C: 
SMIL Quick Reference” beginning on page 181. 


Creating a SMIL File 


You can create a SMIL file (extension .smil) with any text editor or word 
processor that can save output as plain text. If you are familiar with HTML 
mark-up, you will pick up SMIL quickly. In its simplest form, a SMIL file lists 
multiple media clips played in sequence: 


<smil> 
<body> 
<audio src="rtsp://realserver.company.com/one.rm”/> 
<audio src="rtsp://realserver.company.com/two.rm”/> 
<audio src="rtsp://realserver.company.com/three.rm”/> 
</body> 
</smil> 
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SMIL General Rules 


SMIL has many similarities to HTML, but also some important differences. 
When you create your SMIL file, keep the following general rules in mind. 


Mark-up Starts with <smil> and Ends with </smil> 

The SMIL mark-up must start with a <smil> tag and end with the </smil> 
closing tag. All other mark-up appears between these two tags: 

<smil> 

...all other SMIL mark-up... 

</smil> 


Body Section is Required but Header Section is Optional 
A SMIL file can include an optional header section defined by <head> and 
</head> tags. It requires a body section defined by <body> and </body> tags: 
<smil> 
<head> 
...optional section with all header mark-up... 
</head> 
<body> 
...required section with all body mark-up... 
</body> 
</smil> 


The header section is used to specify presentation information, as noted in 


“Adding Presentation Information” on page 91, and to define clip layout, as 
described in “Laying Out Multiple Clips” on page 95. 


Lowercase Text for Tags and Attributes 
SMIL tags and attributes must be lowercase. 


Some Tags Must Close with a Forward Slash 
A tag that does not have a corresponding end tag (for example, the <smil> tag 
has the end tag </smil>), must close with a forward slash. For example: 


<audio src="first.rm”/> 


Attribute Values Enclosed in Double Quotation Marks 

Attribute values, such as “first.rm” shown above, must be enclosed in double 
quotation marks. File names in SMIL must reflect the file name exactly as it 
appears on the server. They can use upper, lower, or mixed case. 
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SMIL Files Use the Extension .smi or .smil 

Save your SMIL file with the extension .smi or .smil. The latter extension (.smil) 
is preferred to avoid possible conflict with other files. Do not include spaces in 
the file name. For example, you can have the file my_presentation.smil but not 
the file my presentation.smil. 


Coded Characters Used in Header 

You need to use codes to add quotation marks, apostrophes, ampersands, or 
angle brackets to content in a SMIL header, such as a presentation title. See 
“Using Coded Characters” on page 94. 


HTML-Style Comments Allowed 
As in HTML, the SMIL comment tag starts with <!-- and ends with -->. The 
ending does not include a forward slash: 


<!-- This is a comment --> 


Indentation Recommended 

Although examples in this chapter indent SMIL tags to various levels to 
illustrate the SMIL structure, indentation is not required. Indenting your 
SMIL files like the examples shown below will help you keep track of the SMIL 
functions, though. 


Specifying Clip Locations 
To add a clip to the presentation, you include in the SMIL body section a clip 
source tag that describes the clip type and location: 


<audio src="rtsp://realserver.company.com/audio/first.rm” /> 
The tag begins with one of the clip type attributes listed in the following table. 


Source Clip Attributes 
Clip Attribute | Used For 


animation Animation clips, such as Shockwave Flash (.swf) used in RealFlash. 
audio Audio clips such as RealAudio (.rm). 
img JPEG (.jpg) or GIF images (.gif). See also “Defining Image Options” 
on page 111. 
ref Any clip type not covered by other attributes, such as a RealPix file 
__ | Grp). 
text Static text clips (.txt). 


(Table Page 1 of 2) 
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Source Clip Attributes (continued) 
Clip Attribute | Used For 
textstream Streaming RealText clips (.rt). 


video Video or other clips that display continuous motion, such as 
RealVideo (.rm). 
(Table Page 2 of 2) 


Additional Information 
For a list of supported streaming formats, see 
“Choosing Media to Stream” on page 11. 


Although a source clip tag must start with a clip type attribute, attributes do 
not affect playback because RealPlayer determines the clip type through other 
means. Specifying a text clip as audio, for example, does not adversely affect 
playback. Although using the different clip attributes helps you keep track of 
the media types, you could specify all clips with ref, for example. 


After the clip type attribute, the src attribute lists the clip location. How you 
specify this location depends on whether you will stream the presentation 
with RealServer, download the clip from a Web server, or play clips back from 
a local computer. 


Linking to Clips on RealServer 


When a RealSystem G2 presentation streams over a network, the media clips 
reside on RealServer. Each source clip’s src attribute gives the clip’s URL: 
<audio src="rtsp://realserver.company.com:554/audio/first.rm” /> 

The following table explains the URL components in the example above. 


Contact your RealServer administrator to get the RealServer address, RTSP 
port, and directory structure. 


RealServer URL Components 
Component Meaning 
TEESE nIEy IIE SSSSS SEED 
rtsp:// RTSP streaming protocol. In contrast, URLs in Web pages 


start with http://. Although RealServer also supports 
HTTP, RealServer clips should always use RTSP. 


realserver.company.com | RealServer address. This varies for each RealServer. It 


typically uses an identifier such as realserver instead of 
www. Or it may use a TCP/IP address such as 
172.2.16.230 instead of a name. 


(Table Page 1 of 2) 
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RealServer URL Components (continued) 


Component Meaning 


1554 RealServer port for RTSP connections. Port 554 is the 
default, so you can leave this out of URLs unless the 
RealServer administrator changed the RTSP port. If the 
port number is required, separate it from the address with 


a colon. 
/audio/ RealServer directory that holds the clip. The directory 
structure may be several levels deep. 
first.rm Clip file name. 
(Table Page 2 of 2) 
Creating Relative URLs 


If your presentation includes many clips that are on the same server, you can 
make each URL relative to a base target that you define in the header: 


<head> 
<meta name="base” content="rtsp://realserver.company.com/”/> 
</head> 
<body> 
<audio src="audio/first.rm”/> 
<audio src="audio/second.rm”/> 
<audio src="rtsp://realserver.real.com/audio/third.rm”/> 
</body> 


Because the third clip has a full URL specified for it, the base target is ignored. 
For the first two clips, however, the src values are appended to the base target, 
effectively giving the clips these URLs: 


rtsp://realserver.company.com/audio/first.rm 
rtsp://realserver.company.com/audio/second.rm 


If no base target is given, RealPlayer assumes that the clip paths are relative to 
the location of the SMIL file. In the example above, therefore, you could leave 
the base target out if the SMIL file itself resides in a directory that contains 
the audio subdirectory that in turn holds the RealAudio clips. 


Tip 
The relative syntax for SMIL files works like relative 
links in HTML, so you can use directory notation such 
as “../”. You can find additional information about this 
topic in an HTML reference guide. 
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Linking to Clips on a Web Server 


To use a clip hosted on a Web server, use a standard HTTP URL such as the 
following in a clip source tag: 


<img src="http://www.company.com/images/Logo.gif” /> 


URLs to clips on a Web server can also be relative to a base target as described 
above. Keep in mind that although a Web server can host any clip, a Web 
server cannot perform all the functions of RealServer. 


Additional Information 
See “Hosting a Presentation on a Server” on page 21 and 
“Limitations on Web Server Playback” on page 151. 


Linking to Local Clips 


If your presentation clips will reside on the user’s local computer (as with a 
multimedia tutorial included with a software application, for example), you 
include the SMIL file locally as well. The src attributes in the SMIL file list 
presentation clips in this format: 


src="audio/first.rm” 


This example is a local, relative link to a clip that resides one level below the 
SMIL file in the audio directory. For local access, you typically want to use 
relative links because you cannot be sure where users will place clips on their 
machines. 


Alternately, you can use absolute, local links to specify exact locations. The 
syntax for absolute links is the same as with HTML. It varies with operating 
systems, however, and you should be familiar with the directory syntax for the 
system you’re using. For example, the following absolute link syntax works for 
Windows machines, but not UNIX or Macintosh: 


src="file://c:\audio\first.rm” 


Warning 
Microsoft Internet Explorer 3.0 tries to display local 
SMIL files as HTML. To support this browser, omit the 
<head> tag or launch the presentation through a Ram 
file as described in “Creating a Ram File Manually” on 
page 153. This problem does not occur with Netscape 
Navigator or Internet Explorer 4.0. Nor does it occur 
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when you stream clips from a server to Internet Explorer 
3.0: 


Grouping Clips 


With the SMIL <seq> and <par> tags, you can create groups that structure your 
presentation. The following sections explain how to play clips in sequence or 
parallel, as well as how to repeat groups or clips within groups. 


Playing Clips in Sequence 


Use the <seq> tag to play clips in sequence. In the following example, the 
second clip begins when the first clip finishes. 
<seq> 
<audio src="audio/newsong.rm”/> 
<audio src="audio/oldsong.rm”/> 
</seq> 


If your presentation included just the clips above, you wouldn’t need to use 
the <seq> tag. You could simply list the clips in order and RealPlayer would 
play them in sequence. The <seq> tag is most commonly combined with <par> 
to create combinations of sequential and parallel clips. 


Playing Clips in Parallel 


You can play two or more clips at the same time through the <par> tag. For 
example, the following combines a RealVideo clip with a RealText clip: 
<par> 

<video src="videos/newsong.rm”/> 

<textstream src="lyrics/newsong.rt”/> 
</par> 


When you play clips in parallel, be sure that they do not exceed the 
presentation bandwidth as described in “Choosing a Target Bandwidth” on 
page 29. When RealServer G2 streams parallel groups, it ensures that the clips 
stay synchronized. If some video frames don’t arrive, for example, RealServer 
either drops those frames or halts playback until the frames arrive. 


Additional Information 
When multiple visual clips play in parallel, you need to 
define each clip’s playback region. For more 
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information, see “Laying Out Multiple Clips” on page 
95. 


Ending a Parallel Group on a Specific Clip 


By default, a <par> group ends once all clips finish playing back. You can 
modify this with an end timing value as described in “Setting Begin and End 
Times” on page 85. Or you can use the endsync attribute to stop the group 
when a specific clip finishes playback: 


<par endsync="first”> 

</par> 

first 

Use the attribute endsync=“first” to stop the <par> group the first time a clip in 
the group ends playback. All other clips in the group stop playing at that 


point regardless of their playback status and any timing parameters specified 
for them. 


last 

The attribute endsync=“last” causes the <par> group to conclude when all clips 
have finished playing. Because this is the default value, you can omit the 
endsync attribute from the <par> tag to achieve this effect. 


id(clip id) 
The attribute endsync=“id(clip id)” causes the <par> group to conclude when 
the specified clip reaches its end. All other clips in the group stop playing at 
that point regardless of their playback status and any timing parameters 
specified for them. The specified clip must have a corresponding id value in its 
source tag: 
<par endsync=“id(vid)”> 

<video id="vid” src="videos/newsong.rm”/> 

<textstream src="Llyrics/newsong.rt”/> 
</par> 


Repeating a Clip or Group 


The repeat=“n” attribute makes a clip or group play a specified number of 
times. You can add it to a clip source tag, for example: 


<video src="videos/newsong.rm” repeat="4" /> 


You can also add it to a <seq> or <par> group to make the entire group repeat: 
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<par repeat="3"> 
<video src="videos/newsong.rm”/> 
<textstream src="lyrics/newsong.rt”/> 
</par> 


In the following example, a video clip within a <par> group plays twice. 
Assuming the video lasts longer than the text stream, the <par> group ends 
when the video concludes its second playback: 
<par> 

<video src="videos/newsong.rm” repeat="2”" /> 

<textstream src="lyrics/newsong.rt”/> 
</par> 


In the following <seq> group, the second video plays only after the first video 
plays twice: 
<seq> 
<video src="videos/newsong.rm” repeat="2” /> 
<video src="videos/newsong2.rm”/> 
</seq> 


Combining <seq> and <par>Tags 


You can combine and nest <seq> and <par> tags as needed. Note that the 
organization of these tags greatly affects the presentation playback: 


<seq> 
clip 1 
<par> 
clip 2 
clip 3 
</par> 
clip 4 
</seq> 


In the example above, clip 1 plays first. When it finishes, clip 2 and clip 3 play 
together. When both clip 2 and clip 3 have finished, clip 4 plays. You get very 
different results, though, if you switch the <seq> and <par> groupings: 
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<par> 
clip 1 
<seq> 
clip 2 
clip 3 
</seq> 
clip 4 
</par> 


In this example, clip 1, clip 2, and clip 4 all begin at the same time. When clip 
2 finishes, clip 3 starts. The following figure illustrates the difference between 


these different groupings. 


Different Playback Results with <seq> and <par> Groups 


Specifying Timing 


SMIL timing elements let you specify when a clip or group starts playing and 
how long it plays. All timing elements are optional. If you do not set them, 
clips start and stop according to their normal timelines and their positions 
within <par> and <seq> groups. The easiest way to designate a time is with 
shorthand markers of h, min, s, and ms as illustrated in the following table. 


Timing Shorthand Examples 


Shorthand Example Value 


2.5h 
2.75min 


2 hours, 30 minutes 


2 minutes, 45 seconds 
(Table Page 1 of 2) 
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Timing Shorthand Examples (continued) 


Shorthand Example Value 


15.555 
670.2ms 


15 seconds, 550 milliseconds 
670.2 milliseconds 


(Table Page 2 of 2) 


Tip 
Decimal values are not required. You can express two 
seconds as “2s” or “2.0s”, for example. 


Normal Play Time Format 

You can also express time elements in a hh:mm:ss.xy format. Here, hh is hours, 
mm is minutes, ss is seconds, x is tenths of seconds, and y is hundredths of 
seconds. In this example: 


begin="02:34.0" 


the time value is 2 minutes, 34 seconds. If the value does not include a decimal 
point, RealPlayer takes the last value to be seconds. So it reads the following 
value as 2 minutes, 34 seconds rather than as 2 hours, 34 minutes: 


begin="02:34” 


Setting Begin and End Times 


The begin attribute works for any clip or group. You can use it to start a clip at 
a specific point within the timeline: 


<video src="videos/newsong.rm” begin=”"20.5s”/> 


Were this clip in a <par> group, the begin attribute would start the clip playing 
back 20.5 seconds after the group becomes active. If the clip were in a <seq> 
group, the attribute would delay the clip’s normal playback by inserting 20.5 
seconds of blank time before the clip starts. Hence timing is relative to the 
start of the <seq> or <par> group, not the start of the overall presentation. 


Additionally, you can set an end attribute alone or combined with a begin 
attribute as shown here: 


<video src="videos/newsong.rm” begin="20.5s” end="62.7s”"/> 


In this example, the clip ends at 62.7 seconds into its part of the presentation 
timeline, playing a total of 42.2 seconds regardless of the length of its internal 
timeline. If the video’s internal timeline is shorter (30 seconds, for example) 
the fill attribute determines what happens onscreen after the video stops 
playing but before the end time is reached. 
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Additional Information 


“Setting a Fill” on page 88. 


Using Begin and End Times with Groups 


You can use begin or end with a <par> or <seq> group: 

<par begin= “5s” end= “3.5min”> 

</par> 

This begin value delays group playback until 5 seconds after the preceding 
group or clip finishes. The end time means all clips in the group stop playing 
after 3.5 minutes regardless of their states. If all clips reach their normal 


conclusion by 3 minutes and 20 seconds after the group starts, for example, 
the next group or clip starts after 10 seconds of blank time. 


If you use an end time and a repeat attribute as described in “Repeating a Clip 
or Group” on page 82, the group repeats only after the end time elapses. You 
should not set an end time along with an endsync attribute in a <par> group, as 
this sets up conflicting end times. 


Additional Information 
For more on endsync, see “Ending a Parallel Group on a 
Specific Clip” on page 82. 


Setting Internal Clip Begin and End Times 


The clip-begin and clip-end attributes specify a clip’s internal timing marks 
where playback begins and ends. You can use them with clips that have 
internal timelines, such as audio, video, and animation. Do not use them with 
groups or static clips such as still images. Here is an example: 


<video src="videos/newsong.rm” clip-begin="10.5s” clip-end="50.7s"/> 


Here, the clip starts playing at its internal 10.5-second mark rather than at its 
normal beginning. It stops when it reaches its 50.7-second mark, playing for a 
total of 40.2 seconds. 


Note 
Do not use clip-begin and clip-end for a live broadcast or 
when playing clips back from a Web server. For more 
information, see “Limitations on Web Server Playback” 
on page 151 and “Using SMIL with a Broadcast” on page 
164. 
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Combining clip-begin and clip-end with begin and end 


You can combine clip-begin and clip-end attributes with begin and end 
attributes. Here, a begin time has been added to the clip example shown above: 


<video src="videos/newsong.rm” clip-begin="10.5s” clip-end="50.7s” begin="5s" /> 


The begin time delays the clip’s normal starting point by five seconds. When 

this time elapses, the clip starts at its 10.5 second internal timeline marker, 

then plays for 40.2 seconds. In this case, the clip-end attribute determines how 

long the video is active. But you could also add an end attribute as shown here 

to modify this behavior: 

<video src="videos/newsong.rm” clip-begin="10.5s” clip-end="50.7s” begin="5s” 
end="50s" /> 


Combined with begin, the end value of 50 means the clip’s “window” within 
the presentation is 45 seconds. Because the clip stops playing after 40.2 
seconds, there is an extra 4.8 seconds during which the clip does not play but 
remains active. How the video window appears during these final seconds 
depends on the fill attribute. 


Additional Information 


“Setting a Fill” on page 88. 


Setting Durations 
The dur attribute controls how long a clip or group appears after it starts to 
play back. It is useful with graphic images, as shown in this example: 
<img src="graphics/poster.jpg” dur="14.5s” /> 
This dur time makes the graphic disappears 14.5 seconds after it appears. You 
can also use dur in place of end. For example, in the following clip: 
<video src="videos/newsong.rm” begin="20.5s” end="62.7s”"/> 
you can substitute a dur attribute for the end attribute to achieve the same 
result: 
<video src="videos/newsong.rm” begin="20.5s” dur="42.2s”/> 


In both examples, the clips stop playback 42.2 seconds after starting. With the 
end attribute, the total playing time is the end value minus the begin value. The 
dur attribute ignores the begin value, stopping the clip 42.2 seconds after it 
starts. Use either end or dur, therefore, depending on how you want to measure 
time. Do not use both attributes in the same tag, however. 
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Additional Information 
The dur attribute can function like end in a group, too. 
For more information, see “Using Begin and End Times 
with Groups” on page 86. 


Setting a Fill 


The fill attribute determines what happens to the clip immediately after it 
plays to its normal end point, or its specified end time or duration elapses. 
The fill value can be remove or freeze. 


remove 
The default value fill="remove” removes the clip. When this attribute is used 
with a still image, the image disappears once the end time has elapsed. 


freeze 

Use fill=“freeze” to freeze the clip on its last frame. When used with a video, the 
video’s last frame stays on the screen. Suppose that you have a 20-second video 
and specify a 30-second duration with freeze: 


<video src="videos/newsong.rm” dur="30s” fill="freeze” /> 


After the video plays, its last frame displays for 10 seconds. The video 
disappears when the end time elapses. The fill=“freeze” attribute has no effect 
on audio. Do not use fill="freeze” for a graphic image that also uses a dur 
attribute. 


Clip Timing Example 
The following example shows two audio clips with different timing options: 
<par> 
<audio src="song1.rm” clip-begin="30.4s” dur="30s"/> 
<audio src="song2.rm” begin="28s” clip-begin="2.4s” clip-end="13.7s”"/> 
</par> 


The timing options modify the <par> tag so that the two clips start at different 
times. The first clip begins to play immediately, but starts at 30.4 seconds into 
its timeline, playing for exactly 30 seconds. 


The second clip is delayed for 28 seconds. That means it overlaps the first clip 
by 2 seconds. It starts at 2.4 seconds into its timeline and ends at 13.7 seconds 
into its timeline, thus playing for 11.3 seconds. The total playing time for this 
group is 30 seconds for the first clip, plus 11.3 seconds for the second clip, 
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minus the 2 second overlap: 39.3 seconds. The following figure illustrates the 
relationships of the clip timelines to the overall presentation timeline. 


UNG 
NINE 


Clip Timing Example 


Presentation 
Timeline 


Song2.rm 


mn 


<11.3> 


Switching Between Alternate Choices 


With the <switch> tag, you can specify multiple options that RealPlayer can 
choose between. The <switch> group specifies any number of choices in this 
form: 
<switch> 

<choice1 test-attribute="value1”/> 

<choice2 test-attribute=“value2” /> 


</switch> 


RealPlayer looks at choices in order, evaluating each test attribute and its 
value to determine which clip to choose. The choices are typically clip source 
tags such as <video test-attribute="value”/>, but RealPlayer can also choose 
between groups when test attributes appear in <par> or <seq> tags. 


Note 
Every RealPlayer must have a viable choice within a 
<switch> statement. RealPlayer will not play any clip in 
the <switch> group if it finds no satisfactory test 
attribute. The following sections explain how to 
guarantee that every RealPlayer has a viable option. 
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Setting Language Choices 


When the <switch> group test attribute is system-language, each source clip is 
for a different language. The following example shows a video slideshow with 
separate audio narrations in French, German, Spanish, and English. Based on 
the language preference set through its Options menu, as well as the system- 
language code defined in the SMIL file, RealPlayer chooses a clip to play: 
<par> 
<video src="slides/seattle.rm”/> 
<!-- select audio based on RealPlayer language preference setting --> 
<switch> 
<audio src="french/seattle.rm” system-language="fr"/> 
<audio src="german/seattle.rm” system-language="de" /> 
<audio src="spanish/seattle.rm” system-language="es”/> 
<audio src="english/seattle.rm”/> 
</switch> 
</par> 


Because the last option does not have a test attribute, a RealPlayer that does 
not have French, German, or Spanish explicitly set as its preferred language 
chooses the English clip regardless of its actual language setting. RealPlayer 
evaluates options in order, so the last option should be, as shown in this 
example, a default language that applies if no other option is viable. If you list 
no default option and certain RealPlayers prefer languages other than the 
ones you list, those RealPlayers will not play any of the clips. 


Additional Information 
Appendix E starting on page 195 lists the system- 
language codes such as “fr” you use to designate content 
in different languages. 


Setting Bandwidth Choices 


To serve different clips to viewers with different connection speeds, use the 
<switch> tag to define options each RealPlayer can choose based on its 
available bandwidth. As shown below, you can group clips with <par> tags, 
using the system-bitrate attribute to list the approximate bandwidth (in Kbps) 
each group consumes: 
<switch> 
<par system-bitrate="75000"> 
<!--for dual isdn and faster--> 
<audio src="audio/newsong1.rm”/> 
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<video src="video/newsong1.rm"/> 
<textstream src="lyrics/newsong1.rt”/> 
</par> 
<par system-bitrate="47000"> 
<!--for single isdn--> 
<audio src="audio/newsong2.rm” /> 
<video src="video/newsong2.rm” /> 
<textstream src="lyrics/newsong2.rt”/> 
</par> 
<par system-bitrate="20000"> 
<!--for 28.8 modems--> 
<audio src="audio/newsong3.rm”/> 
<video src="video/newsong3.rm”/> 
<textstream src="lyrics/newsong3.rt”/> 
</par> 
</switch> 


Always list system bandwidth options from highest to lowest. RealPlayer 
evaluates options in the order listed, selecting the first viable option even if 
subsequent options suit it better. So if the 28.8 Kbps option is first, a 
RealPlayer with a dual-ISDN connection will choose that option because it is 
the first viable option listed. 


Also ensure that the last option satisfies the lowest bandwidth connection you 
want to support. If you do not list an option suitable for 28.8 Kbps modems, 
for example, RealPlayers connected through those modems will not play the 
presentation. 


Additional Information 
“Writing Complex SMIL Switch Statements” on page 
176 explains how to use <switch> with SureStream clips, 
as well as how to test for both language and bandwidth. 


Adding Presentation Information 


The SMIL file header can use <meta> tags to list presentation information 
such as title, author, and copyright: 
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<head> 
<meta name="title" content="Bob and Susan Discuss Streaming Media"/> 
<meta name="author" content="RealNetworks Media Productions" /> 
<meta name="copyright" content="(c)1998 RealNetworks" /> 
<meta name="abstract" content="Bob and Susan, two Internet technology 
experts, discuss the future of streaming media."/> 
</head> 


This example defines a title, author, copyright, and abstract. You can define 
other values as well, such as an e-mail address, simply by adding an attribute 
such as name="email”. This information displays when the user gives the 
RealPlayer Help>About this Presentation command. In addition, the title 
displays at the top of the RealPlayer window and in the run list under the 
RealPlayer File menu. 


Note 
Name values, as in name="title”, must be lowercase. 
When defining long content such as an abstract, don’t 
use line breaks or tabs within a content value. 


Managing the Playlist 


In addition to the presentation information, RealPlayer keeps a playlist of clip 
titles. Through this playlist, users can play different parts of the SMIL 
presentation. The following example shows the same header information as 
above, but adds titles for each video clip in the body section: 


<smil> 
<head> 
<meta name="title” content="Bob and Susan Discuss Streaming Media" /> 
<meta name="author" content="RealNetworks Media Productions"/> 
<meta name="copyright" content="(c)1998 RealNetworks"/> 
<meta name="abstract" content="Bob and Susan, two Internet technology 
experts, discuss the future of streaming media."/> 
</head> 
<body> 
<seq> 
<video src="clip1.rm" title="Bob Expounds his View"/> 
<video src="clip2.rm" title="Susan Responds with Another Perspective" /> 
<video src="clip3.rm" title="Summary: A Look at the Future"/> 
</seq> 
</body> 
</smil> 
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The titles for the individual clips appear in RealPlayer’s pull-down playlist as 
illustrated in the following figure. The user can also view the playlist with 
RealPlayer’s File>Playlist command. 


RealPlayer’s Pull-Down Playlist Showing Clip Titles 


Bob Expounds his View 
Bab Expounds his View 
Susan Responds with Another Perspective 
Summary: A Look at the Future 

Only the clip titles affect the playlist, but you can also define an author, 
copyright, and abstract for each clip. As illustrated below, clip information 


appears when the RealPlayer user gives the Help>About this Presentation 
command while the clip plays. 


Presentation and Clip Information 


Note that in this figure, the clip information section shows the clip title 
defined in the SMIL file, but also includes author and copyright information 
not defined through SMIL. The author and copyright information is encoded 
in the clip. 


Tips for Defining Clip Information 
The following points explain the relationship between clip information set 
through SMIL and information encoded in a clip. 


- Clips may include their own title, author, and copyright information. 
With RealVideo, for example, this information is encoded within the clip. 
For RealPix, it is set within the RealPix text file. 


93 


CHAPTER 7: Assembling a Presentation with SMIL RealSystem G2 Production Guide 


You can override any title, author, or copyright information encoded in a 
clip by adding title, author, and copyright attributes to the clip’s SMIL 
source tag: 


<ref src="...” title=“title” author=“name” copyright="copyright” /> 


To make the playlist useful, always define a title for each clip through 
SMIL. RealPlayer reads the SMIL titles when the presentation begins. It 
reads a clip’s encoded title only when the clip starts playback. So if you 
define titles through SMIL, RealPlayer can immediately build a playlist 
that allows the user to choose different clips. 


You can set a clip abstract only through SMIL by adding the abstract 
attribute and its appropriate value to the clip’s source tag: 


<ref src="...” abstract="abstract” /> 


Only title, author, copyright, and abstract attributes are supported for clips. 
For the entire presentation, however, you can define any information 
through the header section <meta.../> tags. See “Adding Presentation 
Information” on page 91 for more information. 


For a parallel group, use title, author, copyright, and abstract attributes in 
the <par> tag instead of the clip source tags. Clip titles are ignored, and 
only the group title shows in the playlist. For more on <par>, see “Playing 
Clips in Parallel” on page 81. 


A title, author, copyright, or abstract attribute in a <seq> tag is ignored. This 
information must be defined for individual clips or parallel groups. 


Although it’s easier to set clip information through SMIL, it’s good 
practice to encode the title, author, and copyright information in the clip 
as well. This preserves the clip information in case you stream the clip 
without using a SMIL file. 


Using Coded Characters 


In a header, SMIL interprets quotation marks, apostrophes, ampersands, and 
angle brackets as syntax markers.To have these characters show up as text in 


RealPlayer, you use codes in the header. As shown in the following table, codes 
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begin with an ampersand (“&”) and end with a semicolon (“;”). SMIL 
interprets these codes the same way as popular Web browsers. 


SMIL Coded Characters 


Code Character Example 
&quot; quotation mark 7 
&amp; | ampersand & 
&apos; | apostrophe : 

&lt; | left angle bracket ("less than” sign) < 

&gt; right angle bracket (“greater than” sign) | > 


For example, to add the following as a title: 


“Multimedia’s <smil> & you” 


You enter this in the SMIL file header: 


<meta name="title” content= 
“&quot;Multimedia&apos;s &lt;smil&gt; &amp; you&quot;”/> 


Laying Out Multiple Clips 


If your presentation plays only one clip at a time, you do not need to create a 
layout. Each clip automatically plays in the main RealPlayer window, the 
window resizing automatically for each new clip. If you want to keep the 
playback area stable in size as different clips play back, or if your presentation 
displays several clips at a time, you can define playback areas called “regions” 
within the main RealPlayer window: 


1. In the SMIL file header, you create a <layout> group, using <region> tags to 
name playback regions and define their sizes and locations within the 
RealPlayer main window. See “Defining the Layout” below. 


2. In the SMIL file body, you use region attributes to specify which source 
clips play in which regions. See “Assigning Clips to Regions” on page 103. 


Additional Information 
See “Laying out SMIL Presentations” on page 132 for 
instructions on using RealPlayer’s Netscape plug-in or 
ActiveX control to lay out the presentation in a Web 
page instead of in RealPlayer. 
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Defining the Layout 


When you lay out regions, you create a root-layout region that defines the size 
of the RealPlayer main window. You then create other regions using a simple 
coordinate system measured across and down from the top, left-hand corner 
of the root-layout region. All measurements are in pixels or percentages, with 
zero pixels as the default. The following table lists the attributes that define 
region size and placement. 


Region Size and Placement Attributes 


Attribute Sets Pixel Example Percentage Example 


top="60" 
left="120" 
width="240” 
height="180" 


top="10%" 
left="20%”" 
width="40%" 
height="30%" 


top offset from top of window 


left | offset from left side of window 


width | region width —_ 
height 


region height 


The next figure illustrates the layout of a single playback region within a root- 
layout region. 


Basic Region Layout 


Setting the Root Layout Region 


With the <root-layout.../> tag, you specify the size of the entire playback area 
in pixels (percentages are not accepted for the root-layout region). You cannot 
display images or play clips in the root-layout region, as it is meant to set the 
overall playback area. The example shown below creates a root-layout region 
250 pixels wide by 230 pixels high. When the presentation begins, the 
RealPlayer window expands to this size. Other regions measure their top and 
left offsets from the upper, left-hand corner of this root-layout region: 
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<head> 
<layout> 
<root-layout width="250” height="230"/> 
...other regions defined here... 
</layout> 
</head> 


Note 
Although you can omit root-layout to have RealPlayer 
calculate the playback area based on the sizes of the 
other regions, it is better to define root-layout to avoid 
unexpected results. 


Defining Playback Regions 


You create playback regions for media clips with <region> tags. These regions 
must lay within the root-layout region. Any part of a region that lays outside 
the root-layout region is cut off. Each <region.../> tag must define top, left, 
width, and height attributes. The example below defines two regions named 
“videoregion” and “textregion”: 
<head> 
<layout> 
<root-layout background-color="maroon” width="250" height="230"/> 
<region id="videoregion” top="5" left="5" width="240” height="180"/> 
<region id="textregion” top="200” left="5" width="240" height="20"/> 
</layout> 
</head> 


In this example, both regions are offset 5 pixels to the right of the root-layout 
region’s left edge. The video region displays 5 pixels down from the top of the 
root-layout region, and the text region displays 200 pixels down. The following 
figure illustrates this placement. 
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SMIL Sample Layout with Video and Text Windows 


Tips for Defining Regions 
Note the following about SMIL regions: 


- All regions used in the presentation must be defined in the header. All 
regions are created at the beginning of the presentation, so regions 
containing background colors as described in “Adding a Background 
Color” on page 99 may obscure other regions they overlap. 


- Using region transparency and the z-index attribute, you can emulate 
dynamic creation and destruction of regions. For details, see “Hiding 
Regions with z-index” on page 174. 


- To use a graphic image such as a GIF or a JPEG as a background, define a 
playback region the same size as the root-layout region. Display the image 
in this region and use the z-index attribute to make it display behind other 
regions. 


Additional Information 
See “Ordering Overlapping Regions with z-index” on 
page 101. 


Using Percentage Values for Regions 


For a region’s height, width, and offset measurements, you can use 
percentages that reflect a fraction of the root-layout region’s size. The 
following example uses percentages to define playback areas similar to those 
shown in the sample above: 
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<head> 
<layout> 
<root-layout background-color="maroon” width="250” height="230"/> 
<region id="videoregion” top="2%”" left="2%”" width="96%" height="78%”" /> 
<region id="textregion” top="80%” left="2%”" width="96%”" height="18%" /> 
</layout> 
</head> 


Tips for Using Percentage Values 
Note the following when using percentage values to define regions: 


- You must include a root-layout region defined in pixels when specifying 
region measurements in percentages. 


- You can mix pixels and percentages. You could define the top and left 
offset measurements in percentages, for example, while specifying the 
width and height measurements in pixels. 


- You can use whole and decimal values for percentages. For example, the 
values “4%” and “4.5%” are both valid. 


- Because a region is clipped at the boundary of the root-layout region, no 
percentage value can effectively be more than 100%. 


Adding a Background Color 


By default, the root-layout region is black. All other regions use transparency 
as their default. In the SMIL layout, you can specify another background color 
for any region: 
<layout> 

<root-layout background-color="maroon”/> 

<region id="videoregion” background-color="silver”.../> 

<region id="textregion” background-color="#C2EBD7”.../> 
</layout> 


For the color value, use any RGB hexadecimal value (4RRGGBB) supported by 
HTML, or one of the following predefined color names, listed here with their 
corresponding hexadecimal values: 


white (#FFFFFF) silver (HCOCOCO) gray (#808080) black (#000000) 
yellow (#FFFFOO) fuchsia (#FFOOFF) red (#FFO000) maroon (#800000) 
lime (#00FFOO) olive (#808000) green (#008000) purple (#800080) 
aqua (#00FFFF) teal (#008080) blue (#O000FF) = navy (#000080) 
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Using Transparency 

A region is transparent if you do not define its background color. You can also 
specify “transparent” as a region background color. Transparency means that 
the region is not visible until a clip starts to play in it. However, this is not true 
transparency. If the media clip contains transparency too, you will not see 
through the clip and region to the root-layout region. 


Fitting Clips to Regions 
When a media clip is encoded at a size different from the playback region’s 
defined size, the fit attribute determines how the clip fits the region: 
<region id="videoregion” width="128" height="64”" fit="meet” /> 
The fit attribute uses one of the values described in the following table. If you 


do not specify a fit attribute, the clip uses the default value hidden. In no case 
will media display outside the playback region’s boundaries. 


Region Fit Attributes 
Attribute Action 


Fill Scale the clip so that it fills the region exactly. Image distortion 
occurs if the encoded clip and playback region have different 
height-to-width ratios. 


hidden Keep the clip at its encoded size and place it at the region’s upper, 
(default) | left-hand corner. If the clip is smaller than the region, fill 
remaining space with the region’s background color. If the clip is 
larger than the region, crop out the area that doesn’t fit. 


meet Place the clip at the region’s upper, left-hand corner. Scale the clip 
and preserve its height/width ratio until one dimension is equal to 
the region’s size and the other dimension is within the region’s 
boundaries. Fill empty space with the region’s background color. 


slice Place the clip at the region’s upper, left-hand corner. Scale the clip 
and preserve its height/width ratio until one dimension is equal to 
the region’s size and the other dimension overflows the region’s 
boundaries. Crop the overflow. 


The following figure illustrates the effect that fit attributes have on a source 
clip that plays in windows with different sizes and aspect ratios. 
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Different Clip Scaling Results Based on “fit” Attribute 


Fill Hidden 


ail 2 


Encoded 
Clip Meet m Slice 
Tip 


When scaling media inside a region, keep in mind that 
different types of content scale with different results. A 
video scaled larger than its encoded size may not look 
good. Vector-based media such as RealFlash animation 
scale more easily to fit different region sizes, however. 
Also, scaling a clip consumes CPU on the RealPlayer 
machine. 


Ordering Overlapping Regions with z-index 


If regions overlap, you can use the z-index attribute to determine which 
regions appear in front. The following example creates a video region that 
overlaps an image region: 
<layout> 
<root-layout background-color="gray” width="280" height="220"/> 
<region id="image” top="10” left="10” width="260”" height="200" z-index="0" /> 
<region id="video” top="20” left="20" width="240" height="180”" z-index="1"/> 
</layout> 


This example defines a gray root-layout region 220 pixels high by 280 pixels 
wide. A smaller image region is centered within this gray background. Its z- 
index value of zero makes it display behind all other regions, but not behind 
the root-layout region. The video region centered in the image region appears 
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on top of that region because of its higher value for z-index. Another region 
could overlap the video region with z-index set, for instance, to 2, 5, or 29. The 
following figure illustrates these regions. 


Regions Overlapping through z-index 


10 20 


J 
et a} 


Tips for Defining Z-Index Values 
The following are points to observe when using z-index: 


+ The root-layout region is always behind all other regions and does not use 
z-index. 


+ The z-index values can include negative integers (such as -4), 0 (zero), and 
positive integers (such as S). A region with a z-index value of -4, for 
example, displays behind a region with a value of 0, which displays behind 
a region with a value of S. 


» The default value of 0 (zero) applies if you don’t specify z-index. 


+ Using strictly sequential values such as 0, 1, 2, 3, 4 helps you keep track of 
the layers, but is not necessary. A sequence such as 0, 1, 6, 19, 34 works just 
as well, and leaving gaps in the sequence makes it easier to insert layers 
later. 


* Nonoverlapping clips can have the same values. Side-by-side videos can 
both have z-index="3", for example. 
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+ When overlapping clips have the same value, the clip that starts later in 
the presentation appears in front. 


Additional Information 
See “Hiding Regions with z-index” on page 174 for 
information on using z-index to make regions appear to 
come and go dynamically. 


Assigning Clips to Regions 


After you define the layout in the header section as described in“Defining the 
Layout” starting on page 96, you use region attributes within source tags to 
associate each clip with a region. In the following example, the video and text 
clips are assigned to the video and text regions defined in the header: 
<smil> 
<head> 
<layout> 
<root-layout background-color="maroon” width="250” height="230"/> 
<region id="videoregion” top="5" left="5" width="240" height="180"/> 
<region id="textregion” top="200" left="5" width="240" height="20"/> 
</layout> 
</head> 
<body> 
<par> 
<video src="video.rm” region="videoregion”/> 
<audio src="audio.rm” /> 
<textstream src="text.rt” region="textregion”/> 


</par> 
</body> 
</smil> 


You can reuse regions by assigning sequential clips to them. For example, you 
can play a video clip in a region, then display another clip in that region after 
the first clip finishes. Don’t assign the same region to two clips that play at 
the same time, however. You don’t assign audio clips to regions at all because 
audio does not require a display region. 


SMIL Layout Example 


The following example displays three regions: a news region, a video region, 
and a stock ticker region. The news and video regions are arranged side by side 
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at the top of the RealPlayer display window. The stock ticker region appears 
below them. 


<smil> 
<head> 
<!--presentation with 2 text clips and 1 video clip--> 
<meta name="title” content="Music of the Week” /> 
<layout> 
<root-layout width="430" height="165"/> 
<region id="newsregion” top="0" left="0" width="250" height="144”"/> 
<region id="videoregion” top="0" left="250" width="180" height="144"/> 
<region id="stockregion” top="145” left="0" width="430" height="20"/> 
</layout> 
</head> 
<body> 
<par> 
<!--play these 3 clips simultaneously--> 
<textstream src="news.rt” region="newsregion” /> 
<video src="newsvid.rm” region="videoregion” /> 
<textstream src="stocks.rt” region="stockregion”/> 
</par> 
</body> 
</smil> 


The following figure illustrates the design of these regions. 
SMIL Sample Layout with Text, Video, and Stock Ticker Windows 


430 


Company Press Release 


Polar Bear Airlines to Lease 737 Jet 
DENVER--( Business Wire)--Aug. 12, 1998- 
Denver-based Polar Bear Airlines 
(Nasdaq:Plbr - news) today announced an 
agreement to lease a 737-200 jet from 
Interjet Aviation Investors LLC, Northfield, 
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Linking to Other Media 


A SMIL file can define links to other media. A video might link to a second 
video, for example. When the viewer clicks the link, the second video replaces 
the first. Or the video could link to an HTML page that opens in the viewer’s 
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browser. You can even define areas as hot spots with links that vary over time. 
The bottom corner of a video can link to a different URL every ten seconds, for 
instance. 


Note 
Some media clips can also define hyperlinks. A RealText 
clip, for example, can define hyperlinks for portions of 
text. When a viewer clicks an area where a media clip 
link and a SMIL file link overlap, the SMIL link is used. 


Making a Source Clip a Link 


The simplest type of link connects an entire media source clip to another clip. 
As in HTML, you define the link with <a> and </a> tags. But whereas you 
enclose text between <a> and </a> in HTML, you enclose a media source tag 
between <a> and </a> in SMIL: 
<a href="rtsp://realserver.company.com/video2.rm”> 

<video src="video.rm” region="videoregion” /> 
</a> 


The example above links the source clip video.rm to the target clip video2.rm. 
When a viewer moves the cursor over the source clip as it plays, the cursor 
turns to a hand icon to indicate that the clip is a link. When the viewer clicks 
video.rm as it plays, video2.rm replaces it. The URL begins with rtsp:// if the 
linked clip streams to RealPlayer from RealServer, or http:// if the file 
downloads to the browser from a Web server. When targeting a browser, be 
sure to include the show attribute as described below. 


Additional Information 
For information on RTSP URLs, see “Linking to Clips 
on RealServer” on page 78. 


Targeting RealPlayer or a Browser 


An <a> tag or <anchor> tag (see “Defining Hot Spot Links” on page 106) can 
include a show attribute that determines where a linked clip displays: 
<a href="http://www.company.com/index.htm” show="new”> 
<video src="video.rm” region="videoregion”/> 
</a> 


105 


CHAPTER 7: Assembling a Presentation with SMIL RealSystem G2 Production Guide 


replace 

The default attribute show="replace” causes the linked clip to replace the 
source clip in RealPlayer. This default behavior also occurs if you do not 
include the show attribute in the link. The following are important differences 
between RealPlayer and Web browsers to keep in mind when creating links: 


+ RealPlayer does not include a Back button that allows the viewer to return 
to the link source clip after clicking the link. 


+ Only one instance of RealPlayer can run at a time. You therefore cannot 
open a SMIL link in a new RealPlayer window the way you can open an 
HTML link in a new browser window. 


+ Clicking a link to another SMIL file or clip removes any existing regions. If 
you have three regions defined and the viewer clicks a link in one region, 
for example, the target clip replaces all media clips in all regions. You can 
preserve regions by targeting a SMIL file that defines the same set of 
regions. You cannot preserve the timeline positions of clips playing in 
those regions when the viewer clicks the link, however. 


Additional Information 


“Linking to a SMIL File” on page 109. 


new, pause 
The values new and pause both open the linked clip in the viewer’s default 
browser. The source clip continues to play in RealPlayer if you use show="new”. 
With show="pause”, the source clip pauses in RealPlayer. The viewer can restart 
playback at any time, though, by clicking RealPlayer’s Play button. 


Use either show="new” or show="pause” to open a Web page or another clip 
viewable within a browser. You can use these attributes to link a RealSystem 
presentation to your home page, for example. Do not use them to link to 
another media clip played in RealPlayer, however, such as a SMIL file or a 
RealVideo clip. 


Defining Hot Spot Links 


Within a SMIL file you can define hot spots using an <anchor> tag. Whereas 
the <a> tag turns the entire media source clip into a link, the <anchor> tag 
turns only a defined area into a link. With <anchor> tags you can create links 
similar to those in HTML image maps. But SMIL links can be temporal as well 
as spatial. A link might be valid for just ten seconds during a source clip’s 
timeline, for instance. 
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Setting an Anchor 


The <anchor> tag differs from the <a> tag in that you place it within the media 
source tag rather than before it: 
<video src="video.rm” region="videoregion”> 
<anchor href="rtsp://realserver.company.com/video2.rm” .../> 
</video> 


An <anchor> tag ends with a closing slash. But the media source tag does not 
end with a closing slash as it normally would. Instead, the source tag and its 
subsequent <anchor> tags are followed by a closing source tag, such as </video>. 
The <anchor> tag includes an href attribute that uses rtsp:// if the linked clip 
streams from RealServer, or http:// if the file downloads to the browser from a 
Web server 


Additional Information 
For information on RTSP URLs, see “Linking to Clips 
on RealServer” on page 78. To target a browser with a 
link, see “Targeting RealPlayer or a Browser” on page 
10S. 


Defining Spatial Coordinates 


The <anchor> tag’s coords attribute defines spatial coordinates for the hot spot 
rectangle. Coordinate values in pixels or percentages define the rectangle’s 
offset from the upper, left-hand corner of the media source clip as shown in 
this example: 


<video src="video.rm” region="videoregion”> 
<anchor href="...” coords="20,40,80,120"/> 
</video> 


The coordinate values for the hot spot rectangle follow this order: 
1. left side pixel or percentage value 
2. top pixel or percentage value 
3. right side pixel or percentage value 


4. bottom pixel or percentage value 
The sample above uses pixel values to define a hot spot 60 pixels wide (80 
pixels minus 20 pixels) 80 pixels high (120 pixels minus 40 pixels). It produces 
a hot spot like that shown in the following figure. 
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Hot Spot (Hyperlink) Defined with SMIL 


Percentage Values 

The coords attribute can also use percentage values to create hot spots relative 
to the source clip’s size. The following sample places in the center of the 
source clip a hot spot that is a quarter the size of the source clip: 


<video src="video.rm” region="videoregion”> 
<anchor href="...” coords="25%,25%,75%,75%" /> 
</video> 


The following table lists sample percentage coordinates that define hot spots 
for a source clip. Each hot spot is a quarter the size of the source clip. 


Sample Hot Spot Percentage Coordinates 
Hot Spot Rectangle Position Coordinate Attribute 
coords="0,0,50%,50%" 
coords="50%,0,100%,50%” 
coords="0,50%,50%,100%" 
coords="50%,50%,100%,100%" 
coords="25%,25%,75%,75%" 


Upper, left-hand quadrant 


Upper, right-hand quadrant 


Lower, left-hand quadrant 


Lower, right-hand quadrant 


Tips for Defining Anchor Coordinates 
Note the following when defining hot spots: 


- You can mix pixels and percentages. For example, the coordinates 
“50,50,100%,100%” place the hot spot’s left and top boundaries in and 
down 50 pixels from the source clip’s upper, left-hand corner, respectively. 
But the hot spot’s right and bottom boundaries extend to the source clip’s 
right and bottom edges, respectively, no matter the source clip’s size. 


+ Values such as “30,30,10,10” are ignored. Here, the hot spot’s left side is 
defined as farther to the right than its right side. As well, the top is 
defined to be below the bottom. 
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+ You can use whole and decimal values for percentages. For example, the 
values “4%” and “4.5%” are both valid. 


- A hot spot defined to extend beyond the source clip is clipped at the clip’s 
edge. For example, if the hot spot has coordinates “50,50,300,300” but the 
source clip is 200 by 200 pixels, the hot spot’s effective coordinates are 
“$0,50,200,200”. For this reason, no percentage value can effectively be 
more than 100%. 


Setting Temporal Coordinates 


In addition to defining spatial coordinates, the <anchor> tag can set temporal 
attributes that specify when the link is active. If you do not include temporal 

attributes, the link stays active as long as the source clip appears on screen. To 
add timing attributes, use the SMIL begin and end values. (You cannot use dur, 
clip-begin, or clip-end.) 


The following example creates two temporal links for the clip video.rm. The 
first link is active for the first five seconds of playback. The second link is 
active for the next five seconds. Because no spatial coordinates are given, the 
entire video is a link: 
<video src="video.rm” region="videoregion”> 

<anchor href="rtsp://.../video2.rm” begin="0s” end="5s”"/> 

<anchor href="rtsp://.../video3.rm” begin="5s” end="10s"/> 
</video> 


Additional Information 
See “Setting Begin and End Times” on page 85. The 
attributes use the SMIL timing values described in 
“Specifying Timing” on page 84. 


Linking to a SMIL File 


A SMIL file can define a link to another SMIL file or another part of itself. For 
example, a video played through a SMIL file may link to another SMIL file so 
that when a viewer clicks the video, a new presentation starts up in RealPlayer. 
To do this, you simply set the href attribute for the <a> or <anchor> tag to the 
new SMIL file’s URL. 


You can also link to portions of a SMIL file. The following example from a 
target SMIL file uses id attributes (such as those used in regions to create 
region names) to define a target name for a <par> tag that groups a video and a 
text clip. This id attribute functions like a name attribute in an HTML <a> tag: 
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<par id="text_and_video”> 
<video src="video2.rm” region="newsregion” /> 
<textstream src="text.rt” region="textregion”/> 
</par> 


You then link the source SMIL file to the named target by including a pound 

sign (“#”) and the target name within the link URL. Assuming the target SMIL 

file is named newmedia.smil, the source file’s link to the <par> group looks like 

this: 

<a href="rtsp://realserver.company.com/newmedia.smil#text_and_video”> 
<video src="video.rm” region="videoregion”/> 

</a> 

Note that the target SMIL file defines two regions, newsregion and textregion. 

When RealPlayer receives the new SMIL file, it creates those regions as 

specified in the file’s header. 


Tips for Linking to a SMIL File 
Note the following when linking to another SMIL file: 


+ You can link to any media clip or <par> or <seq> group by defining an id 
attribute for the clip or group. Do not link to an element in a SMIL file 
header, however. Although you can link to a <switch> group, do not link to 
a clip or group within a <switch> group. 


+ You cannot link to a media clip in a <par> group and exclude the other 
clips in that group. All clips in the group will play in their designated 
regions. 


+ If additional clips follow the target clip in the SMIL file, those clips play 
when the target clip finishes playback. 


Tip 
If you want to link to a single clip but the SMIL file that 
refers to that clip lists other clips as well, link to the clip 
directly. Or create a new SMIL file that lists only the 
single target clip. 


+ To link to a target within the same SMIL file, simply set the href attribute 
value to the target id, such as <a href="#text_and_video”>. Be sure to 
include the pound sign before the id value. 
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Linking with a Timeline Offset 
You can use the <anchor> tag’s time coordinates to create a timeline offset in a 
linked clip. Suppose you want to link a video to another video at 30 seconds 
into the second video’s timeline. In the source SMIL file, you define an <a> or 
<anchor> link from the first video to a SMIL file that contains the second 
video. In the second SMIL file, the video’s <anchor> tag defines the timeline 
offset using SMIL timing parameters. 
Here is a sample of the link in the first SMIL file: 
<a href="rtsp://realserver.company.com/newmedia.smil#vid2”> 

<video src="video.rm” region="videoregion” /> 

</a> 
The following is the linked video clip in the second SMIL file, newmedia.smil: 
<video src="video2.rm” region="newsregion”> 


<anchor id="vid2” begin="30s” /> 
</video> 


Additional Information 
“Specifying Timing” on page 84 describes the SMIL 
timing values. 


Defining Image Options 
For a still image, you can use the following options to modify the image’s 
streaming characteristics, or to link it to RealPlayer commands. These options 
are not SMIL parameters, but extensions to the image’s SMIL source tag, 
which is described in “Specifying Clip Locations” on page 77. The following 
table summarizes the image options, which are described in detail below. 


Options for Image Source Tag 
Option Function Format Values Example 
bitrate all bits per second | bitrate=1000 


Sets streaming bit 
rate. 


GIF 


bgcolor | Substitutes color for color name or | bgcolor=black 


hex value bgcolor=AA3344 


transparency. 
url Links to URL ora all URL or url=http://www.real.com 
RealPlayer command. command url=command:stop() 


(Table Page 1 of 2) 
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Options for Image Source Tag (continued) 


Option Function Format Values Example 


_ browser 
_player 


Sets browser or 
RealPlayer as target. 


target target=_browser 


target=_player 


reliable reliable=true 


(Table Page 2 of 2) 


Ensures image arrival. | all true 


A question mark operator (“?”) separates image options from the image URL 
in the SMIL source tag. To use multiple image options, put a question mark 
before the first option, then separate the remaining options with ampersands 
(“&”). The order of options does not matter. The following shows the general 
form for two image options added to the image source tag. Note that image 
options and values are not in quotation marks because they are part of the 
quoted src value: 


<image src="URL? option=value&option=value” /> 
Here is an example that combines bit rate and background color options: 


<image src="button.gif?bitrate=1000&bgcolor=blue” /> 


Setting Image Bit Rates 


By default, an image streams at 12 Kbps until RealPlayer receives it. You can 
set a higher bit rate to take advantage of bandwidth availability and stream an 
image quickly. Or you can set a lower bit rate when streaming images in 
parallel with another clip so that the other clip has enough bandwidth for 
uninterrupted playback. The following example shows three sequential image 
files set to stream at a low bit rate to ensure that a video playing in parallel 
does not stall: 
<par> 
<video src="video.rm” region ="videoregion”/> 
<par> 
<seq> 
<image src="ad1.gif?bitrate=1000” begin="30s” dur="60s” region="adregion”/> 
<image src="ad2.gif?bitrate=1000” dur="120s” region="adregion”/> 
<image src="ad3.gif?bitrate=1000” dur="60s” region="adregion”/> 
</seq> 
</par> 
</par> 


In this example, each GIF image is set to stream at 1 Kbps. This ensures that 
each image consumes a small amount of bandwidth and does not interfere 
with video playback. The <par> tag just outside the <seq> tag makes RealServer 
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balance the bit rates of the images as a single group rather than as a discrete 
sequence. 


Additional Information 
For more on using <par> to balance bandwidth, see 
“Smoothing Transitions between Clips” on page 173. 


Keep in mind that the image size divided by the maximum bit rate equals the 
minimum time for streaming the image. Assuming images in this example are 
30 Kilobits, each image takes about 30 seconds to stream. For this reason, the 
first image is set to display 30 seconds after the video begins to play. If no 
begin time were defined, the video would be delayed up to 30 seconds while 
the first image streams to RealPlayer. As well, each successive image must be 
able to stream during the preceding image’s duration. 


Overriding GIF Transparency 


For GIF images that include transparency, you can use bgcolor to substitute a 
color for the transparency. Color values are any hexadecimal color value 
without the leading pound sign (“#”), or a predefined color name as described 
in “Adding a Background Color” on page 99. If you do not set the color, the 
region’s defined background color shows through transparent spots in the 
image. Here is an example: 


<image src="button.gif?bgcolor=BB21AA” /> 


Linking to a Web Page or Clip 


The image url and target options let you link an image with a fully qualified 
URL. When the viewer clicks the image, the URL opens in the viewer’s browser 
or RealPlayer. The following example shows an image linked with a URL that 
opens in the viewer’s default browser: 


<image src="home.gif?url=http://www.company.com&target=_browser” region="home”/> 


The next example shows an image linked with a URL that opens in RealPlayer: 


<image src="go.gif?url=rtsp://realserver.company.com/media.smil&target=_player” 
region="next”/> 


Keep in mind that opening a URL in RealPlayer replaces the current 
presentation with the new clip or SMIL file. 
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Note 
The image hyperlink options duplicate the SMIL 
hyperlink features described in “Linking to Other 
Media”, beginning on page 104. You can use either 
method depending on your preference. 


Controlling RealPlayer 


With url=command:command&target=_player, you can make the image a link that 
causes RealPlayer to stop, pause, play, or seek to a specific point in the 
presentation timeline. The following example shows three images set to 
appear in three separate SMIL regions. Each image issues a different 
RealPlayer command when clicked: 
<par> 
<image src="play.gif?url=command:play() &target=_player” region="play”/> 
<image src="pause.gif?url=command:pause() &target=_player” region="pause” /> 
<image src="stop.gif?url=command:stop() &target=_player” region="stop”/> 
</par> 


An image can also issue a seek command that specifies a certain point in the 
presentation timeline: 


<image src="seek.gif?url=command:seek(1:35.4)&target=_player” 
region="seek”/> 


In the example above, clicking the image instructs RealPlayer to seek to 1:35.4 
into the presentation. This option does not use SMIL shorthand timing values 
such as s for seconds or min for minutes. Instead, the time format is like the 
“Normal Play Time Format” described on page 85, except that it also accepts 
milliseconds and days as possible values. 


dd:hh:mm:ss.xyz 


Here, dd is days, hh is hours, mm is minutes, ss is seconds, x is tenths of 
seconds, y is hundredths of seconds, and z is milliseconds. Only the ss field is 
required. 


When the time value does not include a decimal point, the last field is read as 
the seconds. For example, 1:30 means 1 minute and 30 seconds, whereas 
1:30:00 means 1 hour and 30 minutes. Thus all the following values seek to 
the point in the timeline 90 minutes after the presentation begins: 
url=command:seek(1:30:00.0)&target=_player 


url=command:seek(90:00) &target=_player 
url=command:seek(5400)&target=_player 
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Ensuring Reliable Image Transmission 


Use the reliable=true option to indicate that the image must be delivered to 
RealPlayer under any circumstance: 


<image src="button.gif?reliable=true” /> 


During extremely adverse network conditions, RealSystem will halt the 
presentation if necessary rather than drop the image. You should use this 
option sparingly, though, because RealSystem normally ensures that very little 
data loss occurs in transmission. 
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PLAYING CLIPS IN A WEB PAGE TF \ 


Embedding a presentation in a Web page provides seamless playback 
without launching RealPlayer as a separate application. You can 
even include RealPlayer controls such as fast forward and pause. 
This chapter explains how you add mark-up to a Web page so that 
people view your RealSystem G2 presentation directly through their 
Web browsers. 


Additional Information 
Refer to this chapter for full information on embedding 
a presentation. For a quick example of how to embed a 
video in a Web page, see “Embedding a RealVideo Clip 
in a Web Page” on page 169. 


Choosing the Netscape Plug-in or ActiveX Control 


To provide Web page playback, RealPlayer includes a plug-in for browsers that 
support the Netscape plug-in architecture: 


+ Netscape Navigator 3.0, 4.0, and higher. 
- Microsoft Internet Explorer 3.0 and 4.0. 


It also has an ActiveX control that provides playback capabilities within these 
products: 


+ Microsoft Internet Explorer 3.0 and 4.0. 


+ Any application that supports ActiveX controls, such as Visual Basic, 
Visual C++, Microsoft Access, and so on. 


Because they both have the same capabilities, you can use either the plug-in or 
the ActiveX control depending on which products you need to support. The 
following sections describe the basics of using the plug-in or the control, then 
explain each parameter you can set. 
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Note 
Familiarity with RealPlayer and HTML will make it 
easier to use the plug-in or control. In the examples 
below, ellipses (...) indicate information left out to keep 
the examples short. Make sure your tags include all 
necessary information. 


Additional Information 
Embedded RealPlayer Extended Functionality Guide at 
http://service.real.com/help/library/index.html 
explains how to use JavaScript or VBScript to extend the 
functionality of the Netscape Plug-in or ActiveX control. 


Using <EMBED> Tags for the Netscape Plug-In 


To use RealPlayer’s Netscape plug-in, you add <EMBED> tags to your Web page 
HTML. Each <EMBED> tag has three required parameters (SRC, WIDTH, HEIGHT), 
and can include many optional parameters. The basic <EMBED> tag looks like 
the following (the SRC value, which is explained below, has been omitted for 
simplicity): 

<EMBED SRC="...” WIDTH=300 HEIGHT=134> 


This tag creates a playback area 300 pixels wide by 134 pixels high within the 
Web page. Parameters typically have the form PARAMETER=value. The parameter 
names can be any case, though this manual shows them uppercase. Except for 
file names, which must typically be lowercase, parameter values are not case- 
sensitive. Unless they are URLs, parameter values do not need to be inside 
quotation marks. 


Supporting Other Browsers 


To accommodate browsers that do not support the Netscape plug-in, use 
<NOEMBED> to define a standard hypertext link to your presentation. The 
unembedded link follows the <EMBED> tag: 


<EMBED SRC=”...” WIDTH=300 HEIGHT=134> 
<NOEMBED><A HREF="...”>Play with RealPlayer.</A></NOEMBED> 


In this example, browsers that can play the embedded presentation hide the 
text between <NOEMBED> and </NOEMBED>. Other browsers ignore the preceding 
<EMBED> tag and display just the hypertext link. The user then clicks the link 
to play the presentation in RealPlayer. 
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Using <OBJECT> Tags for the ActiveX Control 


You embed the RealPlayer ActiveX control in HTML pages with the <OBJECT> 
tag. This tag uses an ID that you select, such as ID=RVOCX, and must have the 
following class ID that identifies RealPlayer: 


CLASSID="clsid:CFCDAA03-8BE4-11cf-B84B-0020AFBBCCFA” 


The <OBJECT> tag also sets the width and height of the playback area within 
the browser. A typical <OBJECT> tag looks like this: 

<OBJECT ID=RVOCX CLASSID="clsid:CFCDAA03-8BE4-11cf-B84B-0020AFBBCCFA” 
WIDTH=300 HEIGHT=134> 


-»» parameters ... 
</OBJECT> 


This tag creates a playback area 300 pixels wide by 134 pixels high within the 
Web page. Between <OBJECT> and </OBJECT>, you can define any number of 
additional parameters in this form: 


<PARAM NAME="name” VALUE="value”> 


PARAM, NAME, and VALUE markers can be any case, though this manual shows 
them uppercase. Parameter values are not case-sensitive except for file names, 
which must typically be lowercase. Always enclose parameter values in double 
quotation marks. 


Setting Basic Parameters 


Both the Netscape plug-in and ActiveX control use the same basic tag 
parameters. As explained above, the tag syntax for the plug-in and the control 
differs, however. The following sections explain the basic parameters you can 
include in each <EMBED> or <OBJECT> tag. 


SRC 

The SRC parameter gives the presentation’s source URL surrounded by double 
quotes. The directory names cannot contain spaces. For the ActiveX control, 
the <OBJECT> tag’s CLASSID parameter causes the presentation to play back in 
the Web page, so you can simply link to the SMIL file or clip within one 
<OBJECT> tag. When linking to a presentation on RealServer, the URL can use 
Ramgen, but this is not necessary: 


<PARAM NAME="SRC” VALUE="http://realserver.company.com:8080/ramgen/sample.smil”> 


When you use the Netscape plug-in, you need to include the SRC parameter in 
every <EMBED> tag. You can specify two types of URLs. The first uses the 
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?embed option to RealServer’s Ramgen, which causes RealPlayer to play the 
clip or SMIL presentation through its Netscape plug-in instead of launching 
as a separate application: 


SRC="http://realserver.company.com:8080/ramgen/sample.smil?embed” 


Additional Information 
For more on Ramgen and presentation URLs, see 
“Linking your Web Page to RealServer” on page 147. 


The second option is to create a Ram file with a .rpm extension and list this 
file in the SRC parameter without including Ramgen and the ?embed option. 
The Ram file then links to your SMIL file or clips. The following example 
links to a.rpm file on a Web server: 


SRC="http://www.company.com/media/sample.rpm” 


Additional Information 
For instructions on writing a .rpm file, see “Creating a 
Ram File Manually” on page 153. 


You must create and link to a .rpm file in any of the following situations: 
- Your RealServer does not use Ramgen. 
- The SMIL file or clip is on a Web server. 


- All files are located on a user’s local computer rather than streamed over a 
network. 


Note 
When linking to local files, you can use relative links or 
absolute links. When you use absolute links with the 
Netscape plug-in, though, use forward slashes in paths. 
For example, instead of file://c:\media\first.rpm, set the 
source as file://c:/media/first.rpm. 


WIDTH and HEIGHT 

Required for each <EMBED> or <OBJECT> tag, the WIDTH and HEIGHT parameters 
set the size of the playback area. If you leave them out, the playback area may 
appear as a tiny icon because streaming media presentations do not size 
automatically. The values for WIDTH and HEIGHT are in pixels by default, so a 
width of 300 creates a playback area 300 pixels wide. Setting WIDTH and HEIGHT 
to 0 (zero) hides the playback area. 
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You can also express WIDTH and HEIGHT as percentages of the browser window 
size. For example, a width of 50% makes the presentation area half the browser 
width. Keep in mind that different types of media scale with different results. 
A video scaled larger than its encoded size may not look good. Vector-based 
media such as RealFlash animation scale more easily to fit different playback 
areas, however. 


NOJAVA 


Setting NOJAVA to true in every <EMBED> tag prevents the browser’s Java Virtual 
Machine (JVM) from starting if it is not yet running: 


<EMBED SRC=”...” WIDTH=300 HEIGHT=134 NOJAVA=true> 


This is recommended when using the Netscape plug-in because the JVM is not 
required for the <EMBED> parameters described in this chapter. Starting the 
JVM therefore delays presentation playback unnecessarily. The JVM is required 
only when extending plug-in functionality with JavaScript. In this case, omit 
NOJAVA entirely from the <EMBED> tags. 


Additional Information 
See Embedded RealPlayer Extended Functionality Guide at 
http://service.real.com/help/library/index.html for 
more information on controlling RealPlayer with 
JavaScript. 


Note 
Although you can include NOJAVA as an ActiveX 
parameter, it has no effect on Internet Explorer, which 
launches its JVM on browser start-up. 


Adding RealPlayer Controls 


With the CONTROLS parameter, you can place RealPlayer controls such as a 
play/pause button in your Web page. A visitor to your page can then control 
the presentation playback just as if using RealPlayer as a separate application. 
The following example for the Netscape <EMBED> tag displays the play/pause 
button: 


<EMBED SRC=”...” WIDTH=26 HEIGHT=26 NOJAVA=true CONTROLS=PlayButton> 


For the ActiveX control, you define a CONTROLS parameter within the <OBJECT> 
tag structure: 
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<OBJECT ID=RVOCX CLASSID="...” WIDTH=26 HEIGHT=26> 
<PARAM NAME="SRC” VALUE="...”> 

<PARAM NAME="CONTROLS” VALUE="PlayButton” > 
</OBJECT> 


The following sections describe each RealPlayer control you can use. A tag’s 
WIDTH and HEIGHT parameters set the control’s size. The suggested pixel widths 
and heights given below produce embedded controls approximately the same 
sizes as the RealPlayer controls. Specifying different pixel sizes scales the 
controls larger or smaller. You can also use percentage values for sizes, but this 
is recommended only for the image window. 


Additional Information 
For information on adding more than one control to 
your Web page, see “Linking Multiple Controls” on page . 
127. 


Tip 
Download the HTML version of this manual from 
http://service.real.com/help/library/index.html to 
see online examples of embedded RealPlayer controls. 


Basic Controls 


ImageWindow 


Displays the image window. This is available only for display presentations 
such as video or animation. Even if no other controls are visible on the page, 
the user can typically right-click (on Windows) or hold down the mouse 
button (Macintosh) on the playback area to display a menu of choices such as 
Play and Stop. See also “Controlling Image Display” on page 129. 


Suggested pixel width: 176 or higher 
Suggested pixel height: 132 or higher 
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All 


Displays the basic RealPlayer control panel. The control name “default” also 
works. Buttons include play, pause, stop, fast forward, and rewind. Sliders 
include a position slider and a volume slider with mute button that pops up 
when the speaker button is clicked. Below the buttons are a clip information 
field, a status panel, a network congestion indicator, and a clip timing field. 


Suggested pixel width: 375 
Suggested pixel height: 100 


Individual Controls and Sliders 


ControlPanel 


Displays the play, pause, stop, fast forward and rewind buttons. There’s also a 
position slider, along with a volume slider and mute button that pops up 
when the speaker button is clicked. 

Suggested pixel width: 350 

Suggested pixel height: 36 


__ PlayButton 
Displays a play/pause button. 
Suggested pixel width: 44 
Suggested pixel height: 26 


PlayOnlyButton 
Displays a play button. 


Suggested pixel width: 26 
Suggested pixel height: 26 
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PauseButton 


Displays a pause button. 


Suggested pixel width: 26 
Suggested pixel height: 26 


StopButton 


F | Displays a stop button. 
Suggested pixel width: 26 
Suggested pixel height: 26 


FFCtrl 
| Displays a fast forward control. 


Suggested pixel width: 26 
Suggested pixel height: 26 


RWCtrl 
| Displays a rewind control. 


Suggested pixel width: 26 
Suggested pixel height: 26 


MuteCtrl 
Displays a mute button. 


Suggested pixel width: 26 
Suggested pixel height: 26 


1 MuteVolume 


_ Displays a mute button and volume slider. 


_ Suggested pixel width: 26 
Suggested pixel height: 88 


_ VolumeSlider 
Displays a volume slider. 


: Suggested pixel width: 26 
Suggested pixel height: 65 


124 


RealSystem G2 Production Guide CHAPTER 8: Playing Clips in a Web Page 


PositionSlider 


ees tne 
Displays a clip position slider. 
Suggested pixel width: 120 
Suggested pixel height: 26 


TACCtrl 


Clip Info: [Embedded RealPl 


Displays a clip information field. For instructions on formatting the clip 
playlist, see “Managing the Playlist” on page 92. 


Suggested pixel width: 370 
Suggested pixel height: 32 


HomeCtrl 


trea!) Displays the Real™ logo. 


Suggested pixel width: 45 
Suggested pixel height: 25 


Information Panels 


InfoVolumePanel 


Displays presentation information along with the volume slider and mute 
button. For more on presentation information, see “Adding Presentation 
Information” on page 91. See also “NOLABELS” on page 130. 

Suggested pixel width: 325 

Suggested pixel height: 55 
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InfoPanel 


Displays the presentation information panel. For more on presentation 
information, see “Adding Presentation Information” on page 91. See also 
“NOLABELS” on page 130. 


Suggested pixel width: 300 
Suggested pixel height: 55 


Status Panels 


StatusBar 


Displays the status panel, which shows informational messages. It also 
includes the network congestion LED and the position field, which shows 
current place in the presentation timeline along with total clip length. 


Suggested pixel width: 300 
Suggested pixel height: 30 


Note 
The status bar is included in the All control. If you do 
not embed a status bar or status field in your page, error 
messages display in the browser’s status bar. 


StatusField 


Displays the message text area of the status bar. If you do not embed a status 
field or status bar in your page, error messages display in the browser’s status 


bar. 


Suggested pixel width: 200 
Suggested pixel height: 30 
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PositionField 


Displays the position field, which shows the clip’s current place in the 
presentation timeline and the total clip length. 


Suggested pixel width: 90 
Suggested pixel height: 30 


Linking Multiple Controls 


The CONSOLE parameter defines a name that unifies <EMBED> or <OBJECT> tags 
so that multiple controls work together. For example, you could create three 
separate <EMBED> or <OBJECT> tags to define an image window, a play button, 
and a stop button. By using three tags, you can set the size of each control 
separately and define its layout with HTML tags. You could put each control 
in a different HTML table cell, for example. 


To tie controls together, define the same CONSOLE name within each <EMBED> 
or <OBJECT> tag, or use one of these predefined names: 


_master links the control to all other embedded controls on the page. 
_unique links the control to no other embedded controls on the page. 


You can have multiple console names for separate presentations. For a page 
showing two video clips, for example, you can define console names of video 
and video2. All controls linked by video1 interoperate and all controls linked by 
video2 interoperate. But a video1 volume slider, for example, will not affect the 
volume of a video? clip. 


Tips for Using Consoles 
Note the following when grouping multiple controls with CONSOLE attributes: 


+ Every <EMBED> tag must have a SRC attribute. Tags linked by a console 
name should have the same SRC value. 


» With the ActiveX control, only one <OBJECT> tag in a console group needs 
to have a SRC value. 


+ If the <EMBED> or <OBJECT> tags in a console group have different SRC 
values, the first valid source that RealPlayer finds among those choices 
becomes the console source. This may not always be the first source listed. 
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+ Clicking a play button for one console stops playback for other consoles. 
This allows multiple consoles to play separate audio tracks or to use the 
same image window. 


Multiple Controls Example 


The following examples for the <EMBED> and <OBJECT> tags set up an image 
window and two sets of controls (a play button and stop button) for separate 
videos, sample1.rm and sample2.rm. The predefined console name _master links 
the image window to both control sets. The control sets use different console 
names, however, so they do not link to each other. Clicking each play button 
therefore starts a different video. 


Netscape Plug-in Sample Mark-up 

Because each <EMBED> tag must have a SRC value, the image window in the 
following example simply uses the same source as the first play button. The 
viewer simply clicks either play button to start a video. Clicking the other play 
button stops the first video and plays the second video. 


<EMBED SRC="http://realserver.company.com:8080/ramgen/sample1.rm?embed” 
WIDTH=176 HEIGHT=128 NOJAVA=true CONTROLS=ImageWindow CONSOLE=_master> 


<H4>Video 1</H4> 

<EMBED SRC="http://realserver.company.com:8080/ramgen/sample1.rm?embed” 
WIDTH=44 HEIGHT=26 NOJAVA=true CONTROLS=PlayButton CONSOLE=video1> 
<EMBED SRC="http://realserver.company.com:8080/ramgen/sample1.rm?embed” 
WIDTH=26 HEIGHT=26 NOJAVA=true CONTROLS=StopButton CONSOLE=video1> 


<H4>Video 2</H4> 

<EMBED SRC="http://realserver.company.com:8080/ramgen/sample2.rm?embed” 
WIDTH=44 HEIGHT=26 NOJAVA=true CONTROLS=PlayButton CONSOLE=video2> 
<EMBED SRC="http://realserver.company.com:8080/ramgen/sample2.rm?embed” 
WIDTH=26 HEIGHT=26 NOJAVA=true CONTROLS=StopButton CONSOLE=video2> 


ActiveX Control Sample Mark-up 

In the following ActiveX example, only the controls for the two play buttons 
define the source URLs. For convenience the CLASSID value is omitted. 
<OBJECT ID=RVOCX CLASSID="...” WIDTH=176 HEIGHT=128> 

<PARAM NAME="CONTROLS” VALUE="ImageWindow’> 


<PARAM NAME="CONSOLE” VALUE="_master”> 
</OBJECT> 
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<H4>Video 1</H4> 
<OBJECT ID=RVOCX CLASSID="...” WIDTH=44 HEIGHT=26> 
<PARAM NAME="SRC” 
VALUE="http://realserver.company.com:8080/ramgen/samplel.rm”> 
<PARAM NAME="CONTROLS” VALUE="PlayButton”> 
<PARAM NAME="CONSOLE” VALUE="video1”> 
</OBJECT> 
<OBJECT ID=RVOCX CLASSID="...” WIDTH=26 HEIGHT=26> 
<PARAM NAME="CONTROLS” VALUE="StopButton”> 
<PARAM NAME="CONSOLE” VALUE="video1”> 
</OBJECT> 


<H4>Video 2</H4> 
<OBJECT ID=RVOCX CLASSID="...” WIDTH=44 HEIGHT=26> 
<PARAM NAME="SRC” 
VALUE="http://realserver.company.com:8080/ramgen/sample2.rm”> 
<PARAM NAME="CONTROLS” VALUE="PlayButton”> 
<PARAM NAME="CONSOLE” VALUE="video2”> 
</OBJECT> 
<OBJECT ID=RVOCX CLASSID="...” WIDTH=26 HEIGHT=26> 
<PARAM NAME="CONTROLS” VALUE="StopButton”> 
<PARAM NAME="CONSOLE” VALUE="video2”> 
</OBJECT> 


Controlling Image Display 


The following <EMBED> and <OBJECT> parameters control aspects of how clips 
play back. 


BACKGROUNDCOLOR 

This parameter specifies a background color for the image window. The 
specified background color also shows through if a clip includes transparency. 
The background color is black by default. You can use an RGB hexadecimal 
color value (#4RRGGBB) or the following color names, shown here with their 
corresponding RGB values: 


white (#FFFFFF) silver (HCOCOCO) gray (#808080) black (#000000) 
yellow (#FFFFOO) fuchsia (#FFOOFF) red (#FFO000) maroon (#800000) 
lime (#OOFFOO) olive (#808000) green (#008000) purple (#800080) 
aqua (#00FFFF) teal (#008080) blue (HOOOOFF) navy (#000080) 
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Note 
SMIL region background colors override this 
background color. For more on setting SMIL region 
colors, see “Adding a Background Color” on page 99. 


CENTER 

The default value for CENTER is false, which causes the clip to fill the entire 
playback area. If you set CENTER to true, the clip is centered within the playback 
area and displays at its encoded size. So by setting CENTER to true, you can 
create a large playback area with WIDTH and HEIGHT and still have the clip play 
at its normal size. You cannot use CENTER along with MAINTAINASPECT. 


MAINTAINASPECT 

This parameter, which you cannot combine with CENTER, determines whether 
the clip’s height-to-width ratio stays constant when the clip scales to fit the 
image window. The default value of false causes this ratio to change as 
necessary to fill the image window fully. This may distort the source image. 


If you set MAINTAINASPECT to true, a clip’s height-to-width ratio stays constant. 
For example, a clip’s height-to-width ratio of 1:1 stays constant even if the 
image window’s height-to-width ratio is 2:3. In these cases, the clip is centered 
in the image window and scaled until one dimension reaches the window’s 
boundaries and the other dimension is within the boundaries. The following 
figure shows how clips scale by default, with MAINTAINASPECT set to true, and 
with CENTER set to true. 


Clip Scaling with MAINTAINASPECT and CENTER 


CENTER 
“true" 


Source Clip 


Default Clip MAINTAINASPECT 
“true” 


NOLABELS 
When you use a control that includes presentation information such as title, 
author, and copyright, you can include the NOLABELS option to suppress that 
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information in RealPlayer 5.0. This option has no effect on RealPlayer G2. 
Here is an example for the Netscape plug-in: 


<EMBED ... CONTROLS=ALL NOLABELS=true> 


and an example for the ActiveX control: 


<OBJECT ...> 

<PARAM NAME="CONTROLS” VALUE="ALL’> 
<PARAM NAME="NOLABELS” VALUE="true”> 
</OBJECT> 


Additional Information 
“Parameter Reference” on page 135 lists the options that 
work with RealPlayer 5.0. 


NOLOGO 

When set to true, NOLOGO prevents the Real logo from displaying in the image 
window. When no clip is playing, only the specified background color shows 
in the window. The parameter is false by default. 


Setting Automatic Playback 


The AUTOSTART, LOOP, and NUMLOOP parameters let you set the content to start 
playing automatically, as well as loop continuously for a specified number of 
times. The following example shows two of these parameters used with the 
Netscape plug-in: 

<EMBED SRC="...” WIDTH=50% HEIGHT=50% NOJAVA=true AUTOSTART=true 
LOOP=true> 


Here is an example for the ActiveX control: 

<OBJECT ID=RVOCX CLASSID="...” WIDTH=50% HEIGHT=50%> 
<PARAM NAME="SRC” VALUE=”...”> 

<PARAM NAME="AUTOSTART” VALUE="true”> 

<PARAM NAME="LOOP” VALUE="true”> 

</OBJECT> 


AUTOSTART 

When set to true, the AUTOSTART parameter starts playback immediately. When 
you have multiple <EMBED> or <OBJECT> tags linked by a CONSOLE name, set 
AUTOSTART to true in just one tag. Leaving AUTOSTART out or setting its value to 
false means the presentation does not start until the user starts it, for 
example, by clicking an embedded play button. 
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LOOP 

If the LOOP parameter is set to true, the presentation continuously loops until 
the viewer stops it. When you have multiple <EMBED> or <OBJECT> tags linked 
by a CONSOLE name, set looping in just one tag. If you leave the LOOP parameter 
out, the default value of false applies and the presentation stops after the first 
playback. The user can play the presentation again by clicking the play button. 


NUMLOOP 

If you specify a NUMLOOP value such as "2”, the presentation loops the specified 
number of times and then stops. If both LOOP and NUMLOOP are used, the LOOP 
parameter is ignored. 


SHUFFLE 

The SHUFFLE parameter is for use only with Ram or SMIL files that list a single 
sequence of clips. When set to true, SHUFFLE makes RealPlayer play back the 
clips in a random order. 


Laying out SMIL Presentations 


As “Laying Out Multiple Clips” on page 95 explains, you can use a SMIL file to 
define separate playback regions for different parts of a presentation. This lets 
you lay out two clips side-by-side, for example. When playing a presentation in 
a Web page, you can define the layout in SMIL or in HTML. 


Defining the Layout with SMIL 


To control the layout through SMIL, you set up the regions and their relative 
placements in the SMIL file. You then use the Netscape plug-in or ActiveX 
control to create a playback region in the Web page large enough to 
accommodate all regions. This SMIL file then produces the same layout when 
played through the Web page or RealPlayer. 


The sample layout shown in “SMIL Layout Example” on page 103 defines 
three regions, creating a total playback area 430 pixels wide by 165 pixels high. 
To accommodate this in your Web page, you define an image window at least 
as large as this through the <EMBED> or <OBJECT> tag. Here are examples for the 
Netscape plug-in: 

<EMBED SRC=”"...” WIDTH=430 HEIGHT=165 NOJAVA=true CONTROLS=ImageWindow 
CONSOLE=one> 


and ActiveX control: 
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<OBJECT ID=RVOCX CLASSID="...” WIDTH=430 HEIGHT=165> 
<PARAM NAME="SRC” VALUE=”"...”> 

<PARAM NAME="CONTROLS” VALUE="ImageWindow”> 
<PARAM NAME="CONSOLE” VALUE="one”> 

</OBJECT> 


The SRC parameter provides the URL to the SMIL file. You can then use 
additional <EMBED> or <OBJECT> tags linked to the “one” console to provide 
RealPlayer controls for the presentation. 


Defining the Layout with HTML 


The second method omits SMIL layout information and defines the layout 
through HTML. You could place an image window and separate RealPlayer 
controls in an HTML table, for example. Each <EMBED> or <OBJECT> tags then 
uses a REGION parameter to define a region name. Clip source tags within the 
SMIL file list which region each clip plays in. For example, the SMIL file 
shown in “SMIL Layout Example” on page 103 lists the following RealText file, 
set to play in the newsregion region: 


<textstream src="news.rt” region="newsregion” /> 


Within the HTML page, the <EMBED> tag that plays news.rt would look like 
this: 
<EMBED SRC="http://realserver.company.com:8080/ramgen/sample.smil?embed” 


WIDTH=250 HEIGHT=144 NOJAVA=true CONTROLS=ImageWindow 
REGION=newsregion CONSOLE=one> 


The <OBJECT> tag would look like this: 


<OBJECT ID=RVOCX CLASSID=”"...” WIDTH=250 HEIGHT=144> 

<PARAM NAME="SRC” 
VALUE="http://realserver.company.com:8080/ramgen/sample.smil”> 

<PARAM NAME="CONTROLS” VALUE="ImageWindow”> 

<PARAM NAME="REGION” VALUE="newsregion”> 

<PARAM NAME="CONSOLE” VALUE="one”> 

</OBJECT> 


You define similar <EMBED> or <OBJECT> tags to create other regions for other 
clips listed in the SMIL file. The SRC parameter in each tag lists the same SMIL 
file. You can also use additional <EMBED> or <OBJECT> tags linked to the same 
console to provide RealPlayer controls for the presentation. 
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Omitting SMIL Layout Information 


When you define the presentation layout through HTML, you must omit the 
<layout> section from the SMIL file header. For example, the SMIL file shown 
in “SMIL Layout Example” on page 103 would not have a <layout> section: 
<smil> 
<head> 
<!--presentation with 2 text clips and 1 video clip--> 
<meta name="title” content="Music of the Week” /> 
</head> 
<body> 
<par> 
<!-- play these 3 clips simultaneously --> 
<textstream src="news.rt” region="newsregion” /> 
<video src="newsvid.rm” region="videoregion” /> 
<textstream src="stocks.rt” region="stockregion” /> 


</par> 
</body> 
</smil> 


Tip 
A SMIL file without a layout still works with RealPlayer 
G2, but RealPlayer automatically creates the layout, and 
the results may not be what you expect. Always include a 
SMIL layout when playing a presentation directly in 
RealPlayer. 


Note 
Because there is no SMIL layout, hot spot links are 
ignored. You can make media clips hyperlinks with the 
SMIL <a>...</a> tags, however. For more on SMIL 
hyperlinks, see “Linking to Other Media” on page 104. 
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Parameter Reference 


The following table lists the <EMBED> and <OBJECT> tag parameters. Parameters compatible 
with RealPlayer 5.0 are indicated in the “5.0?” column. To have an embedded presentation play 
back with RealPlayer 5.0 as well as RealPlayer G2, use only 5.0-compatible parameters. 


<EMBED> and <OBJECT>Tag Parameter s 


Parameter Function 5.0? Values Default Refer To 


AUTOSTART Sets automatic playback. true|false page 131 
es eee 0 eee 
BACKGROUNDCOLOR | Sets background color. no | color name or RGB | black page 129 
hex value 
CENTER Centers clip in window. true|false false page 130 
CONSOLE Links multiple controls. name, _master,or |(none) | page 127 
_unique 
CONTROLS | Adds RealPlayer controls. | yes | control name All page 121 
HEIGHT | Sets window or control height. | yes | percentage or pixels |(none) | page 120 
LOOP | Loops clips indefinitely. no | true|false false page 132 
MAINTAINASPECT | Preserves image aspect ratio. no | true|false false [page 130 
NOJAVA Prevents JVM start-up. no | true|false false page 121 
NOLABELS Suppresses presentation yes | true|false false page 130 
information in RealPlayer S.0. 
NOLOGO Suppresses RealLogo. no |true|false false page 131 
NUMLOOP Loops clip a given number of — | no | any number (none) | page 132 
times. 
___| 
REGION Ties clip to SMIL region. no | SMIL region (none) | page 133 
SHUFFLE Randomizes playback. no | true|false false page 132 
SRC Specifies source clip. yes | URL (none) | page 119 
WIDTH Sets window or control width. | yes | percentage or pixels |(none) | page 120 
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4 
INSERTING ADS IN A PRESENTATION TF 


RealSystem’s Advertising Application and SMIL make it easy to 
insert advertisements into your streaming presentation. You can 
include GIF ad banners, for example, or have a video ad precede 
requested content. This chapter explains how to place ads in SMIL 
presentations. Before you start, you should understand SMIL as 
described in Chapter 7 beginning on page 75. 


How Ad Serving Works 


To use RealSystem’s Advertising Application, you create a SMIL file that lays 
out requested clips and ad clips. Instead of listing ad clip URLs in SMIL tags 
such as <img/> or <video/>, you write <RealAdInsert/> tags that cause 
RealServer to insert ad URLs automatically. RealServer typically gets these ad 
URLs from a third-party ad server. RealSystem can deliver ads in any format 
played by RealPlayer, including GIF, animated GIF, JPEG, RealAudio, 
RealVideo, and RealFlash. 


The URL used to request the SMIL file, not the <RealAdInsert/> tag, 
determines what type of ad appears in place of each <RealAdInsert/> tag. For 
example, your Web page might contain a hyperlink to a SMIL file that looks 
like this: 


<a href="http://realserver.company.com/ramgen/adtag/banner/start.smil’>...</a> 


Here, the URL component /adtag/banner/ indicates that the SMIL file 
contains one or more <RealAdInsert/> tags that RealServer replaces with ad 
URLs. The RealServer administrator might define /adtag/banner/ to mean that 
each <RealAdInsert/> tag is replaced by a single, 486-pixel by 60-pixel banner 
ad. AURL component such as /adtag/rotating_banner/ might indicate banner 
ads that rotate every 30 seconds. Another component such as /adtag/lead_in/ 
might be for RealVideo ads that precede the requested content. 
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To use RealSystem’s Advertising Application, you need to work closely with 
your RealServer administrator. The administrator can tell you the sizes and 
file formats of ads available for streaming, the URLs you'll need to use in your 
Web pages, and other important information. RealServer can also generate 
SMIL files containing ads, or insert ads in existing SMIL presentations. This 
lets you serve ads for existing content without having to write or modify SMIL 
files. 


Tip 
Check with your RealServer administrator on the 
availability of the SMIL generation feature for ad 
streaming. This feature can save development time and 
effort when you want to include ads with existing clips 
or SMIL files. 


Displaying Banner Ads 


RealServer can stream a single banner ad or a series of rotating banner ads 
within a SMIL presentation. Each ad includes a hyperlink that, when clicked, 
opens the URL in the viewer’s Web browser. The RealServer administrator 
defines the banner ad size, and determines how much bandwidth each ad 
uses. For rotating banner ads, the administrator determines how frequently 
RealPlayer displays a new ad. 


Note 
Before creating SMIL files with banner ads, check with 
the administrator on banner ad size, bandwidth, type 
(single ad or rotating ads), and rotation frequency. 


Laying Out the Banner Region 


To integrate banner ads with your presentation, you create a SMIL region in 
which the ad image or rotating image series displays. The following SMIL file 
creates an ad banner region above a video region. The video region is 320 
pixels wide by 240 pixels high. The ad banner region is 468 pixels wide by 60 
pixels high, a common size for ad banners. In the SMIL body section, a <par> 
group plays the requested video and banner ads in their respective regions: 
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<smil> 
<head> 
<!--presentation with video clip and ad banner--> 
<layout> 
<root-layout width="488" height="330" background-color="black”/> 
<region id="ad_banner” top="10” left="10" width="468" height="60"/> 
<region id="videoregion” top="80” left="84” width="320" height="240"/> 
</layout> 
</head> 
<body> 
<par> 
<RealAdInsert region="ad_banner” dur="9:00.0” fill="freeze” /> 
<video src="rtsp://realserver.company.com/videos/newsvid.rm” 
region="videoregion” /> 
</par> 
</body> 
</smil> 


The following figure illustrates this layout of a banner ad region above a 
requested video clip. 


Ad Banner Layout 


Additional Information 
“Laying Out Multiple Clips” on page 95 explains how to 
set up SMIL regions. 
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Setting Banner Ad Properties 


In the SMIL body, instead of an <img/> tag link to an ad image file, you use a 
<RealAdInsert/> tag that triggers automatic ad insertion. In the SMIL example 
above, the ad insertion tag looks like this: 


<RealAdInsert region="ad_banner” dur="9min” fill="freeze” /> 


When RealPlayer requests a SMIL file with an ad insertion tag, RealServer 
replaces the <RealAdInsert/> tag with a SMIL <img/> tag that includes a src 
attribute pointing to a banner ad or, with ad rotation, a series of banner ads. 
The <RealAdInsert/> tag can also contain SMIL attributes such as 
region="ad_banner” and fill="freeze”. RealServer simply includes these SMIL 
attributes in the replacement <img/> tag. A duration time is needed only when 
using rotating banner ads. 


Specifying Durations for Rotating Banner Ads 


To use rotating banner ads with a live broadcast, do not set a duration time in 
the <RealAdInsert/> tag. RealServer then sends new banner ads to RealPlayer as 
long as it plays the broadcast. For prerecorded content, however, set a duration 
approximately equal to the content length. If the requested content is nine 
minutes long, for example, you would set the ad duration as dur="9min”. 


You specify an ad rotation duration when serving prerecorded content so that 
RealSystem can calculate the presentation length. If you set no duration, 
RealServer assumes you want a continuous ad stream for a live broadcast, and 
it disables RealPlayer’s clip position slider. RealServer then sends new ads 
until the viewer halts the presentation. Although the presentation will play 
OK, it will not fast-forward or rewind. 


You can set the ad duration shorter than the requested content if you do not 
want ads to display for the entire length of the presentation. In this case, a 
fill=”remove” or fill="freeze” attribute included in the <RealAdInsert/> tag 
determines if the last ad banner disappears or remains on the screen. 


Do not set the ad duration significantly higher than the length of the content, 
however. RealSystem considers the ad duration when calculating the 
presentation’s total running time. If you set an ad duration of 20 minutes 
with a 10-minute video, for example, RealPlayer indicates in its status bar that 
the presentation lasts 20 minutes. If a viewer moves the RealPlayer clip 
position slider forward to the 15-minute mark, for instance, the video will 
stop. The viewer may conclude that the presentation is flawed. 
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Additional Information 
See “Specifying Timing” on page 84 for more on SMIL 
timing values. 


Interleaving Rich Media Ads with Clips 


Rich media advertising is quickly gaining popularity, with many ad serving 
companies offering rich media ads in formats such as RealVideo or RealFlash. 
With the RealSystem Advertising Application, you can play rich media ads 
before, between, or within requested clips. You simply create a SMIL file that 
defines when and how ads appear in relation to requested clips. Instead of 
supplying URLs to ad clips, you write a <RealAdInsert/> tag that causes 
RealServer to insert the rich media ad automatically. 


Note 
The URL for the SMIL file determines the type of rich 
media ad inserted in place of <RealAdInsert/>. Your 
RealServer administrator sets up these request URLs, 
and can give you information about rich media ad sizes, 
formats, and bandwidths. 


Tip 
Always account for the higher bandwidth requirements 
of rich media ads. Ensure that your target audience has 
sufficient bandwidth to receive the ad as well as the 
requested clips. For more on bandwidth, see Chapter 3 
beginning on page 27. 


Creating a SMIL File for a Rich Media Ad 


To use rich media advertising, create a SMIL file that organizes all clips, 
whether ad clips or requested content. For a rich media ad, use a 
<RealAdInsert/> tag in place of a clip source tag such as <video/>. Rich media 
ads typically play before or between requested clips. Their number, placement, 
and timing depend entirely on how you construct the SMIL file. 


SMIL File with No Regions 


The following SMIL file has no layout. It simply plays two video clips in 
sequence. The first clip is the rich media ad: 
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<smil> 
<body> 
<seq> 
<RealAdInsert/> 
<video src="rtsp://realserver.company.com/video/video.rm"/> 
</seq> 
</body> 
</smil> 


SMIL File with No Regions 


In the preceding example, the lack of SMIL regions causes the RealPlayer 
display window to resize automatically for each clip. To prevent resizing, or to 
lay out clips that play together, define SMIL regions for the clips. Here’s an 
example of one video region defined for two clips played in sequence: 
<smil> 
<head> 
<layout> 
<root-layout width="240" height="180"/> 
<region id="videoregion” width="240" height="180"/> 
</layout> 
</head> 
<body> 
<seq> 
<RealAdInsert region="videoregion” /> 
<video src="rtsp://realserver.company.com/video/video.rm" 
region="videoregion” /> 
</seq> 
</body> 
</smil> 


The <RealAdInsert/> tag above includes the SMIL region attribute to associate 
the ad with the correct SMIL region. You can include other SMIL attributes, 
such as the dur or fill attribute, in a <RealAdInsert/> tag as well. 


Additional Information 
“Laying Out Multiple Clips” on page 95 explains how to 
set up SMIL regions. 


Disabling the RealPlayer Playlist 


When a rich media ad and a requested clip play in sequence, the viewer can 
skip the ad clip by choosing the requested clip in the RealPlayer playlist. To 
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disable the playlist through SMIL, encapsulate the <seq> group in a <par> tag. 
This also helps reduce the second clip’s preroll. Here’s an example: 


<smil> 
<body> 
<par> 
<seq> 
<RealAdInsert/> 
<video src="rtsp://realserver.company.com/video/video.rm"/> 
</seq> 
</par> 
</body> 
</smil> 


Additional Information 
For more on the RealPlayer playlist, see “Managing the 
Playlist” on page 92. 


Playing Interstitial Ads 


By using SMIL’s clip timing commands, you can insert rich media ads within a 
requested clip. The following example inserts three rich media ads into a long 
video called news.rm. The effect is similar to a television program with 
commercial breaks: 


<smil> 
<head> 
<layout> 
<root-layout width="240" height="180"/> 
<region id="videoregion” width="240” height="180"/> 
</layout> 
</head> 
<body> 
<par> 
<seq> 
<video src="news.rm” region="videoregion’ 
<RealAdInsert region="videoregion”/> 
<video src="news.rm” region="videoregion’ 
clip-end="16.75min"/> 
<RealAdInsert region="videoregion”/> 
<video src="news.rm” region="videoregion 
clip-end="24.5min”/> 
<RealAdInsert region="videoregion”/> 
<video src="news.rm” region="videoregion” clip-begin="24.5min”/> 


a 


clip-end="8.5min”/> 


” 


clip-begin="8.5min” 


” 


clip-begin="16.75min” 
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</seq> 
</par> 
</body> 
</smil> 


As shown above, the three ad clips and the main video clip, news.rm, are ina 
<seq> group. The news.rm video begins at its normal beginning and plays for 
8.5 minutes. It then stops while the first ad plays. The news.rm clip then 
resumes where it left off, breaking at later intervals for the second and third 
ads. Because the ad clips include no SMIL timing commands, they play from 
their normal beginnings to normal ends. RealServer delivers a new video ad 
for each <RealAdInsert/> tag. 


Additional Information 
For more on clip timing, see “Setting Internal Clip 
Begin and End Times” on page 86. 
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DELIVERING A PRESENTATION 


When you finish building your RealSystem presentation, you place 

the clips on RealServer for streaming. This chapter explains how to 

link your Web page to your presentation. It also describes how a Web 
server can play back some RealSystem G2 presentations. 


Using RTSP and HTTP in URLs 


A RealSystem presentation served by RealServer G2 involves the HTTP and 
RTSP protocols. If you have experience creating Web pages, you know that 
HTTP is the standard protocol Web browsers and Web servers use to 
communicate. Most Web page URLs begin with http:// to make the file 
download use the HTTP protocol. 


As explained in “Hosting a Presentation on a Server” on page 21, RealServer 
G2 and RealPlayer G2 communicate primarily with RTSP, a new protocol 
designed specifically for streaming media. When you assemble a RealSystem 
presentation, it’s important to understand clearly which URLs should begin 
with http:// and which should begin with rtsp://. 


Use rtsp:// in URLs in which RealPlayer G2 requests clips from RealServer G2. 
These URLs occur in SMIL files (.smil) and Ram files (.ram or .rpm). Use http:// 
in these URLs only if the clips are stored on a Web server instead of RealServer. 
Because a Web server doesn’t use RTSP, you can’t have rtsp:// ina URL toa 
clip stored on a Web server. 


Links to a Web server or RealServer within a Web page (.htm or .html) always 
start with http://. Like Web servers, Web browsers don’t use RTSP and can’t 
interpret streaming information sent by RealPlayer over RTSP. The Web 
browser can connect to RealServer through HTTP, though, because RealServer 
G2 can transmit data with HTTP or RTSP. 
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Additional Information 
For more on SMIL file URLs, see “Linking to Clips on 
RealServer” on page 78 and “Linking to Clips on a Web 
Server” on page 80. See also “URL Reference” on page 
170. 


Streaming Clips from RealServer G2 


When you stream clips from RealServer, the RealServer administrator creates 
content directories and tells you the basic URLs to use. The administrator can 
also set up features such as password authentication and pay-per-view. When 
your media clips and SMIL file are ready, transfer them to RealServer and 
place them in the directories prepared by the administrator. Then link your 
Web page to your presentation as described below. 


Tip 
Because earlier versions of RealServer do not support 
SMIL and RTSP, ensure that RealServer G2 hosts your 
presentation. Also note that RealNetworks production 
tools can transfer files to RealServer automatically. See 


http://www.real.com/products/tools/ for details. 


When you use RealServer, the Ramgen feature can automatically launch 
RealPlayer, eliminating the need to write a separate Ram file. Your Web page 
URL simply points to your media clip or SMIL file on RealServer and includes 
a ramgen parameter. The next figure illustrates the process of requesting a 
presentation through Ramgen. This example uses a SMIL file that coordinates 
multiple clips, but you can also link to a single clip directly without using 
SMIL. 
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Requesting a Presentation from RealServer using Ramgen 


Web Browser 


RealPlayer 


RealServer 


— 


. Using the HTTP protocol, the Web browser requests the SMIL file from 
RealServer. The URL includes a parameter that invokes Ramgen. 


2. RealServer’s response causes the Web browser to launch RealPlayer as a 
helper application and give it the URL to the SMIL file. 


3. RealPlayer requests the SMIL file from RealServer using the RTSP 


protocol. 


4. With the information in the SMIL file, RealPlayer requests and receives 
the streaming media clips. 


Linking your Web Page to RealServer 
With your clips on RealServer, link your Web page to the SMIL file with an 
HTML hypertext link that looks like this: 
<a href="http://realserver.company.com:8080/ramgen/sample.smil”>...</a> 


If the presentation plays back directly in the Web page through RealPlayer’s 
Netscape plug-in, the URL occurs within an <EMBED> or <OBJECT> tag and 
looks like this: 


SRC="http://realserver.company.com:8080/ramgen/sample.smil?embed” 
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The following table explains the components of these URLs. Contact your 
RealServer administrator to get the actual RealServer address, HTTP port, and 
Ramgen directory structure. 


URL Components in a Web Page Link to RealServer G2 
URL Component Meaning 


http:// This makes the browser contact RealServer through the 
HTTP protocol. (Web browsers do not use RTSP.) 


realserver.company.com | This address varies for each RealServer. It typically uses 
an identifier such as realserver instead of www. It may 
also use a numeric TCP/IP address such as 204.71.154.5. 


78080 | This is the port RealServer uses for HTTP connections. 
Separate the port and address with a colon. You can leave 
the port number out if RealServer uses port 80 for HTTP 
connections. Include the port number if RealServer uses 
any port besides 80 for HTTP. 


/ramgen/ As “Using Ramgen” explains, this parameter launches 
RealPlayer without the use of a separate Ram file. 
sample.smil This is the SMIL file for your presentation. If you have 
just one clip to stream, you can link directly to that clip 
instead of a SMIL file. 
mf 
?altplay=file. ext This Ramgen option specifies an alternate presentation 


created for older versions of RealPlayer. See “Listing 
Alternate Presentations” on page 149. 


?embed This Ramgen option embeds the presentation in a Web 
page. See Chapter 8 starting on page 117 for full 


information on Web page playback. 


Using Ramgen 


In your Web page hyperlink, the /ramgen/ parameter causes the Web browser 
to launch RealPlayer without the use of a separate Ram file. This parameter 
designates a virtual directory on RealServer. It may be followed in the URL by 
actual directory listings, as in this example: 


<a href="http://realserver.company.com:8080/ramgen/media/sample.smil”>..</a> 


You should use Ramgen even when linking to a single clip, such as a RealVideo 
(.rm) clip, that automatically launches RealPlayer. If you cannot use Ramgen, 
you can write the Ram file as described in “Creating a Ram File Manually” on 
page 153. 
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Listing Alternate Presentations 


When you update content for RealSystem G2, you can keep existing content 
available for earlier versions of RealPlayer. Suppose you have a RealVideo 5.0 
clip that you want to encode with a RealSystem G2 codec and lay out with 
SMIL. After re-encoding the source file with the new codec and writing the 
SMIL file, you change the link to the 5.0 Ram file to point to the SMIL file, 
using the Ramgen altplay option to list the older clip as an alternate: 


<a href="http://.../ramgen/sample.smil?altplay=old_sample.rm”> 


This link instructs RealServer to point RealPlayer G2 to sample.smil. Earlier 
versions of RealPlayer receive the URL to the older old_sample.rm file. Note 
that the URL specifies the actual clip, not the old Ram file. The older clip 
must reside in the same directory as the new clip or SMIL file. 


Tip 
It is not necessary to keep older content available. If you 
do not use altplay, page visitors using older versions of 
RealPlayer are prompted to upgrade when they click the 
link to the SMIL file. 


Combining Ramgen Options 
The question mark operator (“?”) separates Ramgen options from the main 
URL. To use multiple Ramgen options, you use a question mark before the 
first option, then separate the remaining options with ampersands (“&”). The 
order of options does not matter. For example, the following link uses altplay 
and embed: 
<a href="http://.../ramgen/sample.smil?embed&altplay=old_sample.rm”> 
You can use the question mark operator to include earlier Ram file options 
when using altplay. If your Ram file URL for a RealVideo 5.0 presentation 


specified an end time, for example, include that option in the Ramgen URL 
after altplay. The following shows an end time set for old_sample.rm: 


<a href="http://.../ramgen/sample.smil?altplay=old_sample.rm&end=7:45"> 


Playing Clips from a Web Server 


If you do not have access to RealServer G2, you can host your presentation on 
a Web server. Although not as robust as RealServer streaming, Web server 
playback provides a reasonable method for sending simple presentations to a 
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small number of users. It is not recommended for lengthy or complicated 


presentations, however, or for clips viewed simultaneously by large groups. 


As described in “Launching a Presentation” on page 22, a Ram file launches 
RealPlayer when the presentation plays back from a Web server. You therefore 
need to write the Ram file as described in “Creating a Ram File Manually” on 
page 153 and place it on the Web server. The following figure illustrates the 
process of requesting a presentation from a Web server. All network actions 
use the HTTP protocol. 


Requesting a Presentation from a Web Server 


N 


Web Browser 


1 (http) 


Cli R : 
fi RealPlayer 


Web Server 


. The Web browser requests the Ram file from the Web server. 


The Web server downloads the Ram file to the browser. 


. The Ram file extension (.ram or .rpm) causes the Web browser to launch 


RealPlayer. The .ram extension launches RealPlayer as a separate 
application. The .rpm extension plays the presentation within the Web 


page. 


Additional Information 
For more information on embedding a presentation ina 
Web page, see Chapter 8, starting on page 117. 


. RealPlayer receives the Ram file and requests the SMIL file from the Web 


server. Alternately, the Ram file can simply list a single clip or multiple 
clips played in sequence. 
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S. With the information in the SMIL file, RealPlayer requests and receives 
the clips from the Web server. 


Limitations on Web Server Playback 


As noted in “Hosting a Presentation on a Server” on page 21, a presentation 
downloaded from a Web server is more likely to stall than a presentation 
streamed by RealServer. Web servers are not designed to manage bandwidth or 
keep multiple clips synchronized.To ensure that a presentation hosted by a 
Web server plays as smoothly as possible, observe the following points. 


No SureStream Clips Encoded for Multiple Bandwidths 

A Web server cannot stream just one encoding from a SureStream clip 
encoded for multiple bandwidths. Instead, it downloads the entire clip file, 
causing an unacceptably high preroll. So you must encode each clip for just 
one bandwidth. To support multiple bandwidths, encode separate clips for 
various bandwidths and use SMIL to let RealPlayer choose which clip to play. 


Additional Information 
See “Choosing RealAudio Codecs” on page 45 for 
information on RealAudio and SureStream. For more 
on using SMIL to list clip choices, read “Setting 
Bandwidth Choices” on page 90. 


Limited Ability to Keep Parallel Clips Synchronized 

A Web server does not consider clip timelines when downloading data and 
does not receive feedback from RealPlayer. Web server playback therefore 
makes it harder for RealPlayer to keep clips synchronized. A presentation that 
plays clips in parallel may begin to stall and rebuffer data when the RealPlayer 
connection has little bandwidth to spare. 


For this reason, it may be difficult to deliver RealFlash, which consists of 
synchronized animation and audio. You can, however, combine a large clip 
such as RealVideo with smaller clips, such as image clips or a RealText clip. 
Because RealText consumes little bandwidth, a Web server can download it to 
RealPlayer quickly without interfering with other clips. 


RealPix Presentations Buffer Longer 

When delivered by RealServer, images in a RealPix presentation stream at 
different times depending on their place in the RealPix timeline. This lets you 
structure a RealPix presentation to keep it flowing smoothly. When delivered 
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by a Web server, however, all RealPix images begin to download as soon as 
presentation playback begins. This causes a higher preroll. 


Additional Information 
RealPix Authoring Guide explains bandwidth usage when 
RealServer G2 streams RealPix. This guide is available at 
http://service.real.com/help/library/encoders.html. 


SMIL File Optional 

When delivering a single clip or a few clips played in sequence, you do not need 
a SMIL file. You can simply list the clips in order when writing your Ram file 
as described in “Creating a Ram File Manually” on page 153. You can, however, 
have your Ram file specify a SMIL file that lists the clip locations, creates a 
layout, times the presentation, and so on. 


SMIL Internal Timing Commands not Usable 

Although you can use SMIL to lay out and time your presentation, you should 
not use the clip-begin and clip-end attributes. A Web server cannot begin to 
download a clip at a certain point in its timeline. If you specify clip- 
begin=“5min”, for example, RealPlayer must wait until it has received the first 
five minutes of clip data before it can begin to play the clip back. This creates 
an unacceptably long wait. 


Additional Information 
“Setting Internal Clip Begin and End Times” on page 86 
describes these SMIL commands. 


No Ad Insertion 

The RealSystem ad insertion feature, described in Chapter 9 beginning on 
page 137, does not work with Web servers. Only RealServer can replace 
<RealAdInsert.../> tags in SMIL files with URLs to ad clips. 


No RealPlayer Seeking 

Because a Web server cannot jump to a new position in a clip timeline, the 
RealPlayer position slider cannot fast-forward the clip. If the user moves the 
slider forward, playback pauses as the clip continues to download at its 
normal rate. RealPlayer resumes playback once the clip data reaches the 
requested timeline position. 
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No RTSP URLs 

Because Web servers do not support the RTSP protocol, all URLs in 
presentations hosted by a Web server should begin with http://. This includes 
all URLs in a SMIL file or Ram file. 


No Live Broadcast 
Live broadcast is not possible because Web servers can download only clips 
stored on disk. 


Configuring Web Server MIME Types 


To download a RealSystem presentation from a Web server, the server must be 
configured with the following MIME types. If you are using an ISP, ask the 
ISP’s Web server administrator to configure the MIME types listed in the 
following table. 


Web Server MIME Types for RealSystem Files 


File Type Extension MIME Type 

Ram [ram audio/x-pn-realaudio 
Embedded Ram | .rpm audio/x-pn-realaudio-plugin 
SMIL .smil and .smi lapplication/smil - 7 
RealAudio Ta audio/x-pn-realaudio 
‘RealVideo om application/x-pn-realmedia 
RealPix .rp image/vnd.rn-realpix 

RealText [ort | text/vnd.rn-realtext 


Creating a Ram File Manually 


Whenever possible, launch RealPlayer automatically with RealServer’s 
Ramgen feature as described in “Using Ramgen” on page 148. In some cases, 
though, you may need to write a Ram file: 


+ Streaming from a RealServer not set up to use Ramgen. 
+ Streaming multiple SMIL files in sequence. 
» Hosting a RealSystem presentation from a Web server. 


+ Playing back clips that reside on the user’s local machine. 
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> To create a Ram file: 


1. Open any editor or word processor that can save files as plain text. On the 
top line, enter the full URL of the SMIL file or the media clip. As shown 
below, URLs vary with the playback context. 


- RealServer Streaming 
The following example links to a SMIL file on a RealServer machine 
that does not use Ramgen: 
rtsp://realserver.company.com/media/sample1.smil 


To deliver a few clips or SMIL files in sequence, list the URLs in their 
playback order: 


rtsp://realserver.company.com/media/sample1.smil 
rtsp://realserver.company.com/media/videol.rm 
rtsp://realserver.company.com/media/sample2.smil 
Web Server Playback 


For Web server playback, you specify the HTTP protocol and the Web 
server name, along with the SMIL file or media clip: 


http://www.company.com/media/video1.rm 


To deliver a few clips or SMIL files in sequence, list the URLs in their 
playback order: 


http://www.company.com/media/video1.rm 
http://www.company.com/media/video2.rm 
http://www.company.com/media/sample1.smil 


Local Playback 


For local playback of clips residing on the user’s machine, start the 
URL with file:// and list clips in their locations relative to the Ram 
file. For example, the following specifies a clip that resides one level 
below the Ram file in the media directory: 


file://media/video1.rm 

To deliver a few clips or SMIL files in sequence, list the URLs in their 
playback order: 

file://media/video1.rm 


file://media/video2.rm 
file://media/sample1.smil 
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Additional Information 
These local URLs are like those used in a SMIL file to 
locate media clips. For more information on general 
URL syntax, see “Specifying Clip Locations” on page 77. 


2. For a presentation played back from RealServer, you can support earlier 
versions of RealPlayer (such as RealPlayer 4.0 or 5.0) just as Ramgen does 
with the altplay option. To do this, add the marker --stop-- after the RTSP 
URL. Then specify the URL for the older clip just as it appeared in your 
previous Ram file. Here’s an example: 
rtsp://realserver.company.com:554/sample.smil 
--stop-- 
pnm://realserver.company.com:7070/old_sample.rm 
The second URL specifies the older RealSystem protocol with pnm:// and 
designates RealServer’s PNA port. When RealPlayer connects, it chooses 
the URL based on its favored protocol. For this reason, you cannot list two 
URLS that both use the same protocol, whether rtsp://, pnm://, or http://. 


3. Save the Ram file as plain text with a .ram extension (played in RealPlayer) 
or a .rpm extension (played in the Web browser). 


4. Move your Ram file to RealServer or your Web server. Keep in mind that 
even if all your media clips are on RealServer, you can place the Ram file 
on your Web server. When the browser receives the Ram file from the Web 
server, it turns the file over to RealPlayer, which uses the full URLs in the 
Ram file to request the clips off RealServer. Hence the Ram file and the 
media clips do not need to reside on the same machine. 


S. For .ram files, link your Web page to the Ram file with an HTML 
hyperlink such as this: 
<a href="http://www.company.com/media/sample.ram”>click for video</a> 


For .rpm files, incorporate the link URL in the <EMBED> or <OBJECT> tag as 
described in “Setting Basic Parameters” on page 119. If the Ram file is on 
RealServer, the URL must not use the ramgen parameter. 


Adding Comments to a Ram File 


You can add a comment to a Ram file by using a pound sign (“#”) as the first 
character on a line. The following example shows two lines commented out of 
a Ram file: 
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# Two videos and a SMIL presentation 

# streamed from RealServer G2. 
rtsp://realserver.company.com/media/videol.rm 
rtsp://realserver.company.com/media/video2.rm 
rtsp://realserver.company.com/media/sample2.smil 


Testing your Presentation 


The following are guidelines for making sure your presentation works well 
and reaches its target audience: 


1. Test your presentation in “real world” conditions. If you target 28.8 Kbps 
connections, for example, request the presentation over a 28.8 Kbps 
modem. 


2. Check that the presentation has a preroll (initial buffering) under 15 
seconds. After preroll, the presentation should not rebuffer under normal 
network conditions. 


Additional Information 
“What is Preroll?” on page 28. 


3. Verify that video and audio quality is acceptable. 


4. For a multiclip presentation, verify that clips stay synchronized. Ensure 
that no stalling occurs because too many clips play at the same time or a 
single clip requires too much bandwidth. Test that clips introduced 
during a presentation in progress do not stall playback by requiring too 
much buffering when they start. 


Tip 
If clips introduced during a presentation in progress 
require too much buffering, see “Smoothing Transitions 
between Clips” on page 173. 


5. Make sure that your presentation works well for an “average” CPU for 
your audience. For general Web delivery, test playback on both Pentium 
and Power Macintosh 90 MHz machines. Do not rely on MMX technology 
to enhance playback. Not all Web users have MMX machines. 
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Tip 
If your presentation is CPU-intensive because, for 
example, it uses complex Flash animation or high- 
bandwidth video, note this in your Web page. 


6. When streaming RealAudio, ensure that sound quality is acceptable. You 
may need to experiment with RealAudio codecs to find the best balance 
between clip bandwidth use and sound quality. 


7. When embedding a presentation in a Web page, verify that the playback 
window has the correct location and controls. 


Advertising on RealGuide 


Every day, thousands of people visit RealGuide, RealNetworks’ online guide 
for streaming media sites and live events (http://realguide.real.com/). If you 
regularly host RealAudio or RealVideo content of interest to the public, or you 
have a live event you want to advertise, you can submit your listing to 
RealNetworks. Simply complete an online form to list your site: 


- http://www.timecast.com/help/addsite.html 
or live event: 
+ http://www.timecast.com/help/addevent.html 


In the form, you give the site or event name, URL, short description, and 
contact person. A staff member then verifies your site or event before 
including it on RealGuide. (RealNetworks reserves the right to refuse or edit 
submissions.) For live events, please submit your request at least one business 
day in advance. If you have questions or need to change a listing, please e-mail 
timecast@timecast.com. 
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BROADCASTING A PRESENTATION 


The Internet is swiftly becoming the next great broadcast medium. 
RealSystem G2 lets you broadcast live or prerecorded presentations 
over the Internet or an intranet. This chapter provides background 
on using broadcast applications and RealServer G2 to broadcast 
media. Refer to your tools and RealServer manuals for explicit 
instructions on setting up a broadcast. 


Broadcasting vs. On-demand Delivery 


When a streaming presentation is delivered on demand, it starts from its 
beginning when the viewer clicks the presentation link in a Web page. Each 
viewer can receive the presentation at any time and use RealPlayer’s controls to 
fast-forward or rewind through the presentation. 


In a streaming broadcast, however, the user hosting the broadcast starts the 
8 > > g 
presentation at a certain time. Viewers who click the presentation link join the 
broadcast in progress. Before the broadcast begins and after it completes, the 
prog of P 
presentation URL is not valid. During the broadcast the RealPlayer fast- 
forward and rewind controls do not function. 


To make an analogy, on-demand content is like a movie on videotape. The 
viewer can see it at any time, skip forward, rewind, and pause. A streaming 
broadcast, though, is like a movie shown on a television channel. As with a TV 
broadcast, there are two types of streaming media broadcasts: 


« Live content 


Live content is broadcast as it occurs. For example, you can broadcast the 
output of a video camera across the Internet or an intranet. RealSystem 
encodes the content as RealVideo in real-time without writing the content 
to a RealVideo clip first. 
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- Prerecorded content 


Prerecorded content consists of video or audio you record and write to a 
digitized clip. You can then edit the clip before converting it to a 
streaming format and broadcasting it across a network. To the viewer, the 
presentation looks just like a live broadcast. 


Broadcasting Live or Prerecorded Content 


Live Content RealServer 
a 
Prerecorded ee 
Clip RealPlayers 


on 


é RealPlayers 
—_ 


Broadcasting Tools 


To broadcast a presentation, you need the tools described in the following 
sections. 


Source Capture Equipment 

This equipment captures the broadcast content. It is typically a microphone or 
video camera connected to an audio or video capture card. For text it could be 
a live text feed coming in over a network. 


Editing Equipment 

When you broadcast prerecorded content, you first write the source to a 
digitized file. You can then use editing software to optimize the file for 
broadcast. Live content, however, goes directly from the capture equipment to 
the broadcast application. 


Broadcast Application 

The broadcast application takes the live source and encodes it in the 
appropriate streaming format, sending the output to RealServer. A RealVideo 
broadcast application, for example, encodes a camera’s video output as 
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RealVideo in real-time. A broadcast application typically runs on a separate 
machine that has a network connection to the RealServer machine. To 
broadcast prerecorded content, you typically do not need a broadcast 
application because RealServer can broadcast the clips itself. 


RealNetworks encoding tools have live broadcast capability for audio and RGB 
or YUV video. They guide you through the broadcast process and let you 
connect to RealServer easily. RealSystem’s open architecture also lets you build 
a broadcast application to send RealServer any type of data for broadcast. To 
build a broadcast application, you need the RealSystem G2 Software 
Development Kit (SDK). 


Additional Information 
You can get RealAudio and RealVideo encoding tools 
from http://www.real.com/products/tools/. Sample 
RealText and RealPix broadcast applications are 
available in the RealSystem G2 Authoring Kit at 
http://www.real.com/products/tools/authkit/index. 
html. You can download the entire RealSystem G2 SDK 
from http://www.real.com/devzone/. 


RealServer G2 

RealServer streams the broadcast to RealPlayer. The RealServer administrator 
can give you the broadcast URL and parameters for connecting a broadcast 
application to RealServer. Because each RealServer has a limit on the number 
of streams it can produce, verify that the RealServer you intend to use has 
broadcast capabilities appropriate for your anticipated audience size. 


Tip 
Real Broadcast Network (RBN) provides full services for 
broadcasting small and large events. For details, see 


http://www.real.com/rbn. 


Additional Information 
For information on configuring a broadcast, get 
RealServer Administration Guide, available at 
http://service.real.com/help/library/servers.html. 
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Preparing a Broadcast 


The following are tips for preparing a live or prerecorded broadcast. See the 
manual or online help for your broadcast application for explicit instructions 
on how to encode and broadcast content. 


Use SureStream with RealSystem G2 Codecs 

SureStream technology and RealSystem G2 codecs let you broadcast 
RealAudio or RealVideo at multiple bandwidths. Each viewer’s RealPlayer 
selects an encoding appropriate for its connection speed. RealNetworks 
encoding tools let you specify SureStream when you begin the broadcast. 


Multiple-Bandwidth Broadcast through SureStream 


RealPlayers 


@ 
e 28.8 Kbps 
e 


oR A 


SureStream 
Clip 


112 Kbps 


To broadcast without using SureStream and the RealSystem G2 codecs, you 


need a separate broadcast application running on a separate computer for 
each bandwidth connection you intend to support. This is required because 
older codecs require more CPU for each encoding than do RealSystem G2 
codecs. You then connect each broadcast application to RealServer and 
broadcast the different encodings under different URLs. 


Additional Information 
For more on codecs, see “Choosing RealAudio Codecs” 
on page 45 and “Choosing RealVideo Codecs” on page 
D7. 
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Verify that the Broadcast Machine has Enough CPU Power 

RealNetworks tools can broadcast a SureStream clip for several different 
bandwidths in real-time using just a moderately powerful PC. Refer to your 
broadcast application’s manual or online help for guidelines on machine 
requirements for broadcasting. 


Decide Whether to Archive a Live Broadcast 

RealNetworks encoding tools let you write a live broadcast to a file. RealServer 
can also archive the broadcast to a file. The latter option may be the better 
solution if your broadcast is long and your broadcast machine has limited 
disk space. The RealServer administrator can set up RealServer to archive the 
live broadcast. 


Get the Broadcast URL and RealServer Parameters 

The RealServer administrator can give you the parameters you need to 
connect a broadcast application to RealServer. The administrator will also 
provide the broadcast URL or URLs. 


Perform a Trial Run of a Live Broadcast 

When you broadcast live content, you don’t get a second chance. It’s good 
practice to perform a trial run to ensure that the equipment works properly 
and the broadcast results are what you expect. Because you can’t edit a live 
broadcast the way you can edit a prerecorded file, it’s important to set your 
audio levels and plan your video shots carefully in advance. 


Additional Information 
For pointers on producing audio, see “Capturing 
Audio” on page 41. For video, see “Recording Video” on 
page 53. 


During both the trial run and the live broadcast, view the broadcast output 
with RealPlayer. When RealPlayer connects, check that the buffering time for 
receiving a live stream does not exceed 5-10 seconds. Throughout the 
presentation, keep an eye on the broadcast quality. 


If you experience problems with the broadcast output, use the broadcast 
application to lower the video frame size and frame rate (fps), or select lower- 
bandwidth codecs. If these adjustments do not help, you may need to run your 
broadcast application on a more powerful machine. 
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Advertise a Public Broadcast Event 

If you are broadcasting content that has wide public appeal, advertise your 
event on RealGuide (http://realguide.real.com/), the online guide to 
RealAudio and RealVideo. 


Additional Information 


See “Advertising on RealGuide” on page 157. 


Using SMIL with a Broadcast 


You can use SMIL to coordinate live streams or create a presentation that adds 
prerecorded content to a live broadcast. The following sections gives you tips 
on using SMIL with broadcasts. 


Additional Information 
See Chapter 7 beginning on page 75 for more on SMIL. 
Chapter 9 beginning on page 137 tells how to include 
ads in broadcasts. 


SMIL Limitations for Broadcasts 


Within a SMIL file, you treat a broadcast like any other clip. You can assign 
broadcast streams to SMIL regions and group a broadcast with on-demand 
clips in a <seq> or <par> group, for example. However, you cannot use some 
SMIL features with broadcast streams: 


- You cannot replay a broadcast with the SMIL repeat attribute. 


+ The clip-begin and clip-end attributes do not work with broadcasts. You 
can terminate a broadcast before the stream stops by using the SMIL end 
attribute, however. 


Additional Information 


See “Setting Begin and End Times” on page 85. 


Including On-Demand Clips with Broadcasts 


Using SMIL, you can easily embed a broadcast in a multiclip presentation. 
SMIL can deliver an on-demand RealPix slideshow along with live RealAudio, 
for example, when both are in a <par> group. It cannot synchronize the on- 
demand clip to the live stream, however. The on-demand clip’s timeline starts 
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when the viewer requests the presentation. The broadcast stream’s timeline 
starts when the broadcast begins. 


To illustrate this, suppose viewer A requests the presentation two minutes 
after the broadcast begins, while viewer B requests it four minutes after the 
broadcast begins. At ten minutes into the broadcast, both A and B hear the 
same audio, but viewer A’s RealPix clip is at its eight-minute mark, whereas 
viewer B’s clip is at its six-minute mark. Hence the relationship of the two 
timelines varies for each viewer. 


Synchronizing Multiple Broadcast Streams 


If you have multiple broadcast streams for a single presentation, you can 
synchronize the streams through SMIL. This compensates for the fact that 
you typically cannot start two broadcast applications at exactly the same time. 
For example, you might start a live RealText encoding application a few 
seconds before a live RealVideo stream. When it receives the streams, 
RealPlayer delays playing the RealText stream until it can synchronize it with 
the RealVideo stream. 


Tip 
RealPlayer synchronizes broadcast streams to audio. For 
this reason, start your RealAudio/RealVideo broadcast 
application last. This way RealPlayer will have received 
and buffered the other streams by the time it receives 
the audio. 


The broadcast streams are timestamped according to the broadcast machines’ 
internal clocks. You should therefore run broadcast applications on the same 
machine, or on different machines that have synchronized clocks. To make 
RealPlayer synchronize streams, add a ?wallclock=name option to the broadcast 
source tag URLs in the SMIL file as shown in this example: 
<par> 
<video src="rtsp://realserver.company.com/encoder/video.rm?wallclock=sync"/> 
<textstream src="rtsp://realserver.company.com/live/text.rt?wallclock=sync"/> 


</par> 


All wallclock attributes should use the same name value (sync in the example 
above), which can be any name you choose. The wallclock attribute is not 
needed for an on-demand clip or a single broadcast stream. 
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Warning 
The wallclock attribute works with all RealNetworks clip 
types, including RealAudio, RealVideo, RealPix, and 
RealText. It may not function with other clip types 
broadcast by RealServer, however. 


Additional Information 
Sample RealText and RealPix broadcast applications are 
available in the RealSystem G2 Authoring Kit at 


http://www.real.com/products/tools/authkit/index. 
html. 
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QUICK STEPS FOR STREAMING CLIPS 


This appendix provides examples that show how to set up some 
simple streaming presentations quickly. This information will aid 
you if you are a beginning user. Once you are familiar with the basic 
steps for hosting RealSystem G2 presentations, you can easily create 
more complex presentations. 


Note 
You will need to get the correct URLs for media clips 
from the RealServer or Web server administrator. 
Substitute those values for the example URLs shown 
below. 


Streaming a RealAudio or RealVideo Clip 


It’s simple to add a RealAudio or RealVideo clip to your Web page. Following 
the instructions below, you can stream the clip from RealServer G2 or 
download it from a Web server. The clip plays back in RealPlayer. 


Note 
Before using a Web server, read “Hosting a Presentation 
on a Server” on page 21 and “Limitations on Web Server 
Playback” on page 151. 


> To create the clip: 


1. Prepare your audio or video source file for encoding. This can include 
normalizing the audio source file or setting the video’s window size. 


Additional Information 
“Optimizing Audio” on page 43. “Digitizing Video” on 
page 54. 


167 


APPENDIX A: Quick Steps for Streaming Clips RealSystem G2 Production Guide 


2. Use a RealNetworks encoding tool to encode the RealAudio or RealVideo 
clip from your audio or video source file. RealVideo and RealAudio clips 
use the file extension .rm. 


Note 
Encoding tools are available for free download or 
purchase at http://www.real.com/products/tools/. 


> To stream the clip from RealServer G2 using Ramgen: 


1. Transfer the clip to the RealServer G2 directory prepared by the 
RealServer administrator. 


2. Link your Web page to the clip with an HTML hyperlink that specifies the 
RealServer address, the ramgen parameter, and the HTTP protocol. You 
can get this information from the RealServer administrator. In your 
HTML source file, the link will look like this example: 


<a href="http://realserver.company.com:8080/ramgen/content/myclip.rm”> 
Click here</a> to see my RealVideo presentation. 


Additional Information 


“Streaming Clips from RealServer G2” on page 146. 


3. In your Web browser, click the link to verify that it works. RealPlayer will 
launch as a helper application and, after a few seconds of buffering, will 
play the streaming clip. 


> To play the clip back from a Web server: 


1. With any text editor, open a new file and enter the URL your clip will have 
on the Web server. For example: 
http://www.company.com/media/myclip.rm 


2. Save this file as plain text with the file extension .ram. This is your Ram 


file. 


Additional Information 


“Creating a Ram File Manually” on page 153. 
3. Transfer the media clip and the Ram file to the appropriate directory on 
the Web server. 


4. Link your Web page to the Ram file (not the media clip) with a standard 
HTML hyperlink like this: 
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<a href="http://www.company.com/media/myclip.ram”> 
Click here</a> to see my RealVideo presentation. 


5. In your Web browser, click the link to verify that it works. RealPlayer will 
launch as a helper application and, after a few seconds of buffering, will 


play the clip. 


Additional Information 


“Playing Clips from a Web Server” on page 149. 


Embedding a RealVideo Clip in a Web Page 


Using RealPlayer’s Netscape plug-in, you can embed a RealVideo clip directly 
in your Web page. The following example assumes that the video is 176 pixels 
wide by 132 pixels high. It places the video window and the full RealPlayer 
control panel in your Web page. 


Additional Information 
See “Chapter 8: Playing Clips in a Web Page” beginning 
on page 117. 


> To embed the clip in your Web page: 


1. In your Web page, add the <EMBED> tag with the RealVideo URL, window 
size, and ImageWindow control. The following example assumes RealServer 
G2 will stream the presentation: 
<EMBED WIDTH=176 HEIGHT=132 
SRC="http://realserver.company.com:8080/ramgen/content/myclip.rm?embed” 
CONTROLS=ImageWindow CONSOLE=one NOJAVA=true> 
If you intend to play the clip back from a Web server, use an HTTP URL 
and link to a Ram file with the extension .rpm (see below) as in the 
following example: 
<EMBED WIDTH=176 HEIGHT=132 
SRC="http://www.company.com/media/myclip.rpm” 

CONTROLS=ImageWindow CONSOLE=one NOJAVA=true> 


2. You can then add RealPlayer controls through additional <EMBED> tags 
that all use the same URL for the SRC parameter. The following example 
embeds the full RealPlayer control panel in the Web page, linking it to the 
image window through the same console. It assumes RealServer will 
stream the presentation: 
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<EMBED WIDTH=375 HEIGHT=100 
SRC="http://realserver.company.com:8080/ramgen/content/myclip.rm?embed” 
CONTROLS=ALL CONSOLE=one NOJAVA=true> 

Use an <EMBED> tag like the following when playing the clip back from a 
Web server: 


<EMBED WIDTH=375 HEIGHT=100 
SRC="http://www.company.com/media/myclip.rpm” 
CONTROLS=ALL CONSOLE=one NOJAVA=true> 


Tip 
Because you can place each <EMBED> tag anywhere on 


your Web page, you can lay out the image window and 
controls in any manner using HTML. 


Additional Information 
Download the HTML version of this manual from 
http://service.real.com/help/library/index.html to 


see online examples of embedded RealPlayer controls. 


3. Transfer the clip to the appropriate RealServer G2 or Web server directory. 
When streaming from G2, you are ready to test the clip because the Web 
page already contains the link to the RealVideo clip. 


> To create the Ram file when playing the clip back from a Web server: 


1. With any text editor, open a new file and enter the URL your clip will have 
on the Web server, as in the following example: 


http://www.company.com/media/myclip.rm 


2. Save this file as plain text with the file extension .rpm. This is your Ram 
file. 


3. Transfer the Ram file to the appropriate directory on the Web server. 


4. In your Web browser, click the link to verify that it works. 


URL Reference 


As explained throughout this manual, URLs to files and clips vary depending 
on what kind of file or clip you link to and what type of file contains the link. 
The table below provides a quick reference for the protocol used for various 
types of links. It also shows whether the link should invoke RealServer’s 
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Ramgen utility. This table assumes that the presentation is for RealPlayer G2 
and not earlier versions of RealPlayer. 


Quick URL Reference 
Link from Link to Located on Protocol Ramgen? Reference 
RealServer |http:// | yes 
http:// 
http:// 
http:// 


Web page Media clip 


Web page SMIL file 


Web server 


RealServer 


Web server 


Ram file (.ram | RealServer | http:// 
Web page 
or .rpm) Web server | http:// page 153 
RealServer | rtsp:// no page 78 
SMIL file Media clip Web server |http:// | no page 80 
Local host | file:// no page 80 
RealServer | rtsp:// no page 78 


SMIL file SMIL file Web server page 80 
Local host no page 80 
Media clip Web server | http:// Ino | page 153 
Local host page 153 
SMIL file Web server | http:// page 153 


Local host | file:// Ino page 153 


Ram file 
(.ram or .rpm) 


Ram file 
(.ram or .rpm) 
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ADVANCED PRODUCTION TECHNIQUES 


This appendix will help you utilize the many features of RealSystem 
G2 and SMIL. Before following the production tips given here, make 
sure you have a good understanding of SMIL as described in 
Chapter 7, beginning on page 75. 


Smoothing Transitions between Clips 


By grouping clips played in sequence within a SMIL <par> tag, you can create 
smooth transitions between the clips. When clips normally play in sequence, 
each clip buffers data (its preroll) when it starts to play. By grouping the 
sequence within a <par> tag, though, RealSystem takes advantage of unused 
bandwidth to send clips’ preroll before they start to playback. You can use this 
feature to mask preroll for high-bandwidth clips, for example, by streaming 
the preroll while low-bandwidth, introductory clips play. 


The following SMIL example, which omits the header that defines the region 
layout and base URL, shows how to mask preroll for high-bandwidth clips and 
create smooth transitions between the initial and subsequent clips: 


<body> 
<par> 
<seq> 
<par> 
<!-- group 1: introductory group masking preroll --> 
<audio src="intro.rm” /> 
<textstream src="titles.rt” region="Left” /> 
<textstream src="credits.rt” region="right”/> 
</par> 
<par> 
<!-- group 2: main group with masked preroll --> 
<ref src="graphics.rp” region="left” /> 
<video src="story.rm” region="right”/> 
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</par> 
</seq> 

</par> 
</body> 
Group 1 consists of two RealText clips and a RealAudio clip played in parallel. 
Because of the <seq> tag, the group 1 clips precede the RealPix and RealVideo 
clips in group 2. If the <seq> tag were the highest level of organization, 
RealServer would stream the group 1 clips without regard to group 2, 
streaming data for group 2 clips only after group 1 finished. Viewers would 
experience a delay after group 1 clips finished as RealServer streamed preroll 
for group 2 clips. 


The outer <par> tag just below the <body> tag, however, makes RealSystem 
treat groups 1 and 2 as one large parallel group with subgroups played in 
sequence. Although this doesn’t affect the order in which the clips play, the 
parallel grouping makes RealSystem balance bandwidth between all clips. 
After it starts to stream the group 1 clips, RealServer makes use of unused 
bandwidth by streaming data for group 2 clips while the group 1 clips play. 
This masks the preroll for the group 2 clips. 


Note 
When you enclose clips in a <par> group, the individual 
clips do not appear in the RealPlayer playlist. 


Additional Information 
See “What is Preroll?” on page 28 and “Developing 
Multiclip Presentations” on page 33. 


Hiding Regions with z-index 


RealPlayer creates all regions defined in a SMIL file’s header section when it 
first reads the file. So a single SMIL presentation cannot play clips in a certain 
set of regions, then destroy those regions and create different regions with a 
new layout. To accomplish dynamic layout changes, you can create separate 
SMIL files that define each region set, then play the SMIL files in sequence as 
described in “Creating a Ram File Manually” on page 153. 


An alternative is to create a single SMIL file that uses the <region> tag’s z-index 
parameter to create transparent, overlaying regions. The following SMIL 

header example creates a left region next to a right region. Both are in portrait 
orientation, their heights over twice the value of their widths. A second set of 
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regions, top and bottom, are stacked. These regions have higher z-index values 
meaning that they display in front of the left and right regions: 


>? 


<head> 
<layout> 
<root-layout width="360" height="360"/> 
<!-- first two side-by-side regions --> 
<region id="left” top="10" left="10" width="165” height="340" z-index="0" /> 
<region id="right” top="10" left="185" width="165” height="340" z-index="1” /> 
<!-- second two stacked regions --> 
<region id="top” top="10" left="70" width="220" height="165”" z-index="2” /> 
<region id="bottom” top="185” left="70" width="220" height="165” z-index="3" /> 
</layout> 
</head> 


As defined in the following SMIL body, RealPix and RealText clips first play in 
the left and right regions, which appear beneath the top and bottom regions. 
Because the overlaying top and bottom regions do not use background colors, 
they remain transparent until clips play in them. The introductory RealPix 
and RealText clips disappear when they finish playback, restoring to view the 
root-layout default background color of black. The group 2 clips, a RealVideo 
clip and another RealText clip, then play in the top and bottom regions: 


<body> 
<par> 
<seq> 
<par> 
<!-- group 1: side-by-side titles and credits --> 
<ref src="titles.rp” region="left” fill="remove”/> 
<textstream src="credits.rt” region="right” fill=”remove”/> 
</par> 
<par> 
<!-- group 2: stacked video and subtitles --> 
<video src="story.rm” region="top” /> 
<textstream src="subtitles.rt” region="bottom” /> 
</par> 
</seq> 
</par> 
</body> 


Although the left, right, top, and bottom regions exist from the start of the 
SMIL file playback, the use of z-index, fill=”remove”, and default region 


transparency makes it appear as if the regions are created dynamically with 
each new set of clips. The following figure illustrates the initial region 
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creation, the first set of clips, then the second set of clips playing in the 
RealPlayer window. 


Transparent Region Creation and Ordering 


Regions Titles Credits Subtitles 


Additional Information 
For more on z-index, see “Ordering Overlapping Regions 
with z-index” on page 101. “Laying Out Multiple Clips” 
on page 95 discusses SMIL layouts. 


Writing Complex SMIL Switch Statements 


The SMIL <switch> tag is a powerful feature that lets you specify options that 
each RealPlayer can choose between based on its preference settings and 
available bandwidth. “Switching Between Alternate Choices” on page 89 
explains the basics of using the <switch> tag. The following sections give tips 
on writing complex <switch> statements. 


Switching with SureStream Clips 


With RealAudio or RealVideo clips encoded for multiple bit rates with 
SureStream technology, you may or may not need to use the <switch> tag: 


- When the presentation consists solely of a SureStream clip, simply link to 
that clip within the SMIL file. The clip then streams at the rate 
appropriate for RealPlayer’s connection speed. You do not need to specify 
bandwidth choices with a <switch> group. 


- Use the <switch> tag when combining a SureStream clip with other clips 
encoded for single bandwidths. The SureStream clip is always used, but 
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the <switch> group gives RealPlayer options for other clips. The following 
example illustrates a RealAudio SureStream clip and a choice between two 
RealPix presentations built for different bandwidths: 
<par> 
<audio src="audio/newsong2.rm”/> 
<switch> 
<ref src="image/slideshow1.rp” system-bitrate="47000"/> 
<ref src="image/slideshow2.rp” system-bitrate=”20000” /> 
</switch> 
</par> 


Additional Information 
For more on SureStream, see “Choosing RealAudio 
Codecs” on page 45 and “Choosing RealVideo Codecs” 
on page S7. Refer to “Supporting Multiple Bandwidth 
Connections” on page 34 for more on developing 
presentations for different connection speeds. 


Switching with Multiple Test Attributes 


You can use multiple <switch> test attributes to have RealPlayer choose clips 
based on both bandwidth and language. There are two ways to do this. In this 
first example, each audio clip choice has two test-attributes, one for language 
and one for bandwidth. Both attributes must be viable for RealPlayer to 
choose the clip: 


<switch> 
<!-- French language choices --> 
<audio src="sound/audio_fr2.rm” system-language="fr" system-bitrate="47000"/> 
<audio src="sound/audio_fri.rm” system-language="fr” system-bitrate="20000" /> 
<!-- English language choices (default) --> 
<audio src="sound/audio_en2.rm” system-bitrate="47000"/> 
<audio src="sound/audio_en1.rm” system-bitrate="20000"/> 

</switch> 


Because RealPlayer evaluates the <switch> choices from top to bottom, 
selecting the first viable option, the last two choices do not have system- 
language options. This lets all RealPlayers other than those with French as 
their language preference choose between the two English-language clips. 


The next example adds RealText files in both French and English to the 
presentation possibilities. Here, <switch> statements are nested so that 
RealPlayers with French set as their language preference play the French 
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RealText file and choose from the set of French-language RealAudio files 
based on available bandwidth. All other RealPlayers play the English RealText 
file and choose from a set of English-language RealAudio files: 


<switch> 
<!-- Choose French as the language --> 
<par system-language="fr"> 
<textstream src="text/credits_fr.rt”/> 
<switch> 
<!-- Choose fast or slow bit rate for French audio --> 
<audio src="sound/audio_fr2.rm” system-bitrate="47000"/> 
<audio src="sound/audio_fri.rm” system-bitrate="20000"/> 
</switch> 
</par> 
<!-- Choose English (default) as the language --> 
<par> 
<textstream src="text/credits_en.rt”/> 
<switch> 
<!-- Choose fast or slow bit rate for English audio --> 
<audio src="sound/audio_en2.rm” system-bitrate="47000"/> 
<audio src="sound/audio_en1.rm” system-bitrate="20000"/> 
</switch> 
</par> 
</switch> 


Displaying Captions for the Hearing Impaired 


The RealPlayer G2 preferences window has an option to enable captions for 
the hearing impaired. To author these captions, write a RealText clip that 
coordinates text with the audio timeline. Then create a SMIL file that plays 
the two in parallel. The SMIL attribute system-captions="on” makes the 
captions appear only if the viewer’s preferences enable captions: 


<smil> 
<head> 
<layout> 
<root-layout background-color="blue” width="310" height="200"/> 
<region id="video” width="176" height="132” left="67" top="5"/> 
<region id="captions” width="300" height="50" left="4" top="145"/> 
</layout> 
</head> 
<body> 
<par> 
<video src="news.rm” region="video” /> 
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<textstream src="captions.rt” region="captions” system-captions="on” /> 


</par> 
</body> 
</smil> 


In this example, the RealText file (captions.rt) appears only for viewers who 
have enabled captions in RealPlayer. For all other viewers, the caption region 
shows the root-layout region’s background color. RealPlayer’s captions setting 
does not affect the video clip, which has no system-captions value. Following 
sections explain how to fill the caption region or make it disappear when 
captions are off. 


Tip 
The system-captions attribute also works for <seq> and 
<par> groups. You can use system-captions=“off” to make 
a clip or group play only when system captions are 
turned off in RealPlayer. 


Additional Information 
“Laying Out Multiple Clips” on page 95 discusses SMIL 
layouts. RealText Authoring Guide is available at 
http://service.real.com/help/library/encoders.html. 
The RealPlayer G2 online help can assist you with 
turning captions on and off in the preferences. 


Filling a Captions Region when Captions are Off 


To avoid a blank region when captions are off, you can display another file, 
such as an image file, in the caption region. The following extract is from a 
SMIL file that uses the same layout as the previous example. Here, the parallel 
group includes an image clip with a system-captions="off” attribute. This 
makes the image display only when captions are turned off in RealPlayer: 
<par> 

<video src="news.rm” region="video” /> 

<textstream src="captions.rt” region="captions” system-captions="on"/> 

<img src="filler.gif” region="captions” system-captions=" off” /> 
</par> 
Any clip, not just a static image, can fill the captions region when captions are 


off. The filler clip should be the same size as the RealText captions clip, 
however, when the two display in the same region. 
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Resizing the Playback Area for Captions 


As an extension to SMIL, RealPlayer G2 supports system-captions in layout 
tags. This lets you change layouts when captions are displayed. The following 
SMIL file centers a video region above a captions region only when RealPlayer 
enables captions. Although this example uses system-captions in the <layout> 
tag, you could use the attribute in <root-layout/> and <region/> tags as well to 
display or hide individual regions based on RealPlayer’s captions setting: 


<smil> 
<head> 
<meta name="title" content="Closed-Captioned News"/> 
<!-- Layout used when captions are on. --> 
<layout system-captions="on”> 
<root-layout background-color="blue” width="310" height="200"/> 
<region id="video” width="176" height="132”" left="67" top="5"/> 
<region id="captions” width="300” height="50" left="4" top="145"/> 
</layout> 
</head> 
<body> 
<par> 
<video src="news.rm” system-captions=" off” /> 
<video src="news.rm” region="video” system-captions="on” /> 
<textstream src="captions.rt” region="captions” system-captions="on” /> 
</par> 
</body> 
</smil> 


With this SMIL file, RealPlayer creates the layout and plays the RealText clip 
in parallel with the video only when captions are on. When captions are off, 
RealPlayer defines no regions and plays only the news.rm clip that includes the 
system-captions=“off” attribute. When captions are off, the SMIL file is 
equivalent to the following: 


<smil> 
<head> 
<meta name="title" content="Closed-Captioned News"/> 
</head> 
<body> 
<video src="news.rm” system-captions=" off" /> 
</body> 
</smil> 
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Once you understand SMIL, use this appendix as reference when 
writing SMIL files. For full information on SMIL and RealSystem 
G2, see Chapter 7 beginning on page 75. In the tables below, an 
asterisk (*) denotes a required attribute. Ellipses (...) designate 
nonessential information left out of the example. 


Header Tags 


<meta.../> 


The header region’s <meta.../> tags provide presentation information. A 
<meta.../> tag can also set a base URL for source clips in the SMIL file. 


<meta.../> Tag Attributes 


Attribute Value Function Reference 
content * | any value Provides content for the name attribute. | page 91 
abstract Gives presentation abstract. page 91 
[a uthor | Lists name of presentation author. page 91 
dace ® base Sets base URL for source clips. page 79 
copyright Supplies presentation copyright. page 91 
title | Gives presentation title, which displays | page 91 

in the RealPlayer run list. 


a 


Note 
You can define other information attributes besides 
abstract, author, copyright, and title. See “Adding 
Presentation Information” on page 91. 
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Examples 

<meta name="author” content="Jane Morales” /> 

<meta name="title” content="Multimedia My Way”/> 

<meta name="copyright” content="(c)1998 Jane Morales” /> 
<meta name="base” content="rtsp://realserver.company.com/"/> 


<layout>...</layout> 


The <layout> and </layout> tags define the layout of visual clips such as video 
and animation. Within the tags, you define a root-layout region and separate 
regions for the clips. The layout must be defined with the SMIL header. 


| <root-layout.../> 
Within <layout>...</layout>, <root-layout> sets the overall size of the playback 
area. Clips do not play in the root-layout area. 
<root-layout.../> Tag Attributes 
Attribute Value Function Reference 


background-color | color name | Sets root-layout color. page 99 
or hex value 


height * pixels Sets playback area height. ee 96 


on|off Determines if root-layout is created | page 180 
based on system captions preference. 


= 


page 96 


system-captions 


width * Sets playback area width. 


Example 

<layout> 
<root-layout background-color="maroon” width="250” height="230"/> 
<region .../> 
<region .../> 

</layout> 
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<region.../> 


Within <layout>...</layout>, <region> tags define the size and placement 
(relative to root-layout) of each region used to play clips. 


<region.../> Tag Attributes 


Attribute Value Function Reference 
background-color | color name or | Sets region background color. page 99 
| hex value 

fit fill, hidden, Determines how clip fits region when | page 100 
meet, or slice | the two are different sizes. 

height * pixels or Sets region height. page 96 
percentage 

mI 
id * name Provides target name for setting clips | page 97 
to play in the region. 

left * pixels or Sets region offset from the left side of | page 96 
percentage the root-layout region. 

system-captions | onloff Determines if region is created based | page 180 

| _|.on system captions preference. 

top * pixels or Sets region offset from the top of the | page 96 
percentage root-layout region. 

width * pixels or Sets region width. page 96 
percentage | L_ 

z-index number Defines order of overlapping regions. | page 101 

Example 

<layout> 


<root-layout .../> 


<region id="video” top="5" left="5" width="240” height="180” 
background-color="blue” fit="fill” z-index="3"/> 


<region.../> 
</layout> 


Clip Source Tags 


To define locations and timing attributes for clips within a presentation, use a 
source tag with one of the following clip type identifiers: 
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<animation.../> 
<audio.../> 
<image.../> 
<ref.../> 
<text.../> 
<textstream.../> 
<video.../> 
<RealAdInsert.../> 


Although a clip type identifier must start a source tag, the identifier does not 
affect playback. All clip source tags can use <ref.../>, for example. The 
<RealAdInsert.../> tag is not a SMIL tag, but a RealSystem tag that RealServer 
replaces with a SMIL tag for an advertising clip. It does not include a src 
attribute, but can include any other SMIL clip attribute. These attributes get 
passed to the replacement tag. See Chapter 9 beginning on page 137 for more 
on <RealAdInsert.../>. 


Clip Source Tag Attributes 


Attribute Value Function Reference 
SEE E EEE ESEEEES SEED 

abstract abstract Gives abstract for clip. page 92 

author name Lists author for clip. page 92 

begin h, min, s, or ms | Delays normal playback time. page 85 

clip-begin h, min, s, or ms | Specifies clip’s internal timing mark | page 86 
where playback begins. 

clip-end h, min, s, or ms | Specifies clip’s internal timing mark _| page 86 
where playback ends. 

copyright copyright Lists copyright information for clip. | page 92 

dur h, min, s, or ms | Sets total time clip plays. Do not use | page 87 
with end. [ 

end h, min, s, or ms | Sets end time for clip relative to begin | page 85 
time. Do not use with dur. 

fill freeze or Freezes or removes (default) clip from | page 88 

remove screen when it stops playing. 

id name Names clip for reference by other page 82 
SMIL elements. | 

region <region.../> | Assigns clip to a region. page 103 


tag id name 


—t 


repeat number Repeats clip the specified number of 


page 82 


times. 
(Table Page 1 of 2) 
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Clip Source Tag Attributes (continued) 


Attribute Value Function Reference 
sic. * URL Provides full or relative URL for clip. | page 77 
system-bitrate | bits per second | Sets bit rate attribute for page 90 
<switch>...</switch>. 
system-captions | on|off Determines if clip plays based on page 178 
system captions preference. 
system-language | language code | Sets language attribute for page 90 
| <switch>...</switch>. 
title title Lists title for clip. page 92 
(Table Page 2 of 2) 
Examples 


<video src="rtsp://realserver.company.com/media/video2.rm” region="video” 
begin="40s” clip-begin="5100ms” clip-end="4.5min” fill="freeze” /> 


<audio src="rtsp://realserver.company.com/media/music.rm” 
dur="10.5s" repeat="5"/> 


Image Source Tag Options 
For a still image, you can include the following options in the image source 
tag. 
Image Source Tag Options 
Option Value Function Reference 
bgcolor | color name or hex Changes GIF transparency to color. page 113 
value 
bitrate [bits per second (bps) | Sets streaming bit rate. page 112 
reliable | true Guarantees reliable image transmission. | page 115 
[browser Makes Web browser the URL target. | page 113 
aoe _player Sets RealPlayer as command target. page 114 
[URL Sends URL to browser on mouse click. {pee 113 
command:play() Gives play command on mouse click. 
command:pause() _| Gives pause command on mouse click. 
url command:seek(time) | Makes RealPlayer seek to specified time | page 114 
in timeline on mouse click. Time has 
dd:hh:mm:ss.xyz format. 
Seeerrerre Gives stop command on mouse click. 
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Group Tags 


A question mark operator (“?”) separates image options from the image URL 
in the clip source tag. Additional options preceded by ampersands (“&”) can 
follow in this format: 


<image src= “URL? option=value&option=value” /> 


Note 
Image options and values are not in quotation marks 
because they are part of the quoted src value. 


Examples 

<image src="ad1.gif?bitrate=1000&bgcolor=blue” /> 

<image src="ad.gif?url=http://www.company.com&target=_browser” .../> 
<image src="stop.gif?url=command:stop()&target=_player” .../> 


<image src="seek.gif?url=command:seek(1:35.4)&target=_player” .../> 


<par>...</par> 


The <par> and </par> tags make enclosed clips play in parallel. No attributes 
are required for a <par> tag. 


<par> Tag Attributes 
Attribute Value Function Reference 
abstract ‘| abstract Gives abstract for group. page 92 
author name Lists author for group. page 92 
begin h, min, s, or ms | Delays normal group playback time. | Page 86 
copyright copyright Lists copyright for group. page 92 
dur h, min, s, or ms | Sets total time group plays. page 87 
end lh, min, s, or ms | Sets end time for group relative to page 86 
begin time. Do not use with endsync. 
| first Ends group when first clip ends. 
endsync last Ends group when last clip ends. page 82 
id(clip id) Ends group when specified clip ends: | 
id name Names group for reference by other _| page 109 
SMIL elements. 


(Table Page 1 of 2) 
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<par> Tag Attributes (continued) 


Attribute Value Function Reference 


number 


repeat Repeats group the specified number 


of times. pages 


—— on 
system-bitrate | bits per second 


Sets bit rate attribute for 
<switch>...</switch>. 


system-captions | on|off Determines if group plays based on 


page 178 
system captions preference. 


system-language | language code | Sets language attribute for 
<switch>...</switch>. 


page 90 


title title Lists title for group. page 92 
(Table Page 2 of 2) 


Examples 
<par> 
<video src="videos/newsong.rm”/> 
<textstream src="lyrics/newsong.rt”/> 
</par> 
<par endsync="id(text)” repeat="2” begin="4s"> 
<video src="videos/newsong.rm”/> . 
<textstream id="text” src="lyrics/newsong.rt”/> 
</par> 


<seq>...</seq> 


The <seq> and </seq> tags group clips that play in sequence. No attributes are 
required for a <seq> tag. 


<seq> Tag Attributes 
Attribute Value Function Reference 
begin h,min,s,orms | Delays normal group playback time. | page 86 
dur Th, min,s,orms_ | Sets total time group plays. page 87 
end h,min,s,orms | Sets end time for group relative to page 86 
| begin time. 
id name | Names group for reference by other | page 109 
SMIL elements. 
repeat number Repeats group the specified number pape 82 
of times. 


(Table Page 1 of 2) 
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<seq> Tag Attributes (continued) 
Attribute Value Function Reference 


system-bitrate | bits per second | Sets bit rate attribute for page 90 
<switch>...</switch>. 


A | i ; 
system-captions | onloff Determines if group plays based on | page 178 
system captions preference. 


system-language language code | Sets language attribute for page 90 


<switch>...</switch>. 
—— rr Eerreeemeneee anensineniinese nme aa ear a a ar aE 
(Table Page 2 of 2) 


al 


Example 

<seq repeat="3"> 
<audio src="rtsp://realserver.company.com/one.rm” /> 
<audio src="rtsp://realserver.company.com/two.rm” /> 


</seq> 


<switch>...</switch> 


The <switch> and </switch> tags contain clips or groups of clips that 
RealPlayer chooses between based on its available bandwidth or language 
preference. Clips or groups that RealPlayer evaluates must include a system- 


bitrate or system-language attribute. 


<switch> Tag Attributes 


Attribute Value Function Reference 


id Names group as a link target for other SMIL files. | page 109 


Additional Information 
See “Switching Between Alternate Choices” on page 89. 


Example 

<switch> 
<audio src="french/seattle.rm” system-language="fr" /> 
<audio src="german/seattle.rm” system-language="de"/> 
<audio src="english/seattle.rm”/> 

</switch> 
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Hyperlink Tags 


<a>...</a> 


The <a>...</a> tags work like HTML hyperlink tags to connect a media source 
clip to another clip. But whereas you enclose text between <a> and </a> in 
HTML, you enclose a media source tag between <a> and </a> in SMIL. 


<a.../> Tag Attributes 
Attribute Value Function Reference 
Sets hyperlink URL. 


Opens URL in browser while RealPlayer continues. 


[new 


| pause Opens URL in browser and pauses RealPlayer. 


Opens URL in RealPlayer. 


show page 105 


replace 
(default) 


Example 

<a href="http://www.company.com/index.htm” show="new”> 
<video src="video.rm” region="videoregion”/> 

</a> 


<anchor.../> 
An <anchor> tag can define a hot spot hyperlink that can be temporal as well as 
spatial. It fits within a media source tag: 


<video ...> 
<anchor .../> 
</video> 


Note that here the <video> source tag does not end with a forward slash as it 
normally does. Instead, a </video> tag follows it and the <anchor.../> tag. 


<anchor.../> Tag Attributes 


Attribute Value Function Reference 


begin h, min, s, or ms 


Defines when hot spot becomes active or when | page 109 
linked media clip begins in its timeline. page 111 


coords | pixels or 


percentages 


Defines boundary for hot spot as left, top, 
right, and bottom offset from source clip. 


page 107 


end h, min, s, or ms | Determines when hot spot deactivates. page 109 
(Table Page 1 of 2) 
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<anchor.../> Tag Attributes (continued) 


Attribute Value Function Reference 
Sets hyperlink URL. 
id name Defines target for use by other hypertext links. | page 111 
new Opens URL in browser while RealPlayer 
continues playback. 
show pause Opens URL in browser and pauses RealPlayer. | page 10S 
replace Opens URL in RealPlayer. 
(default) 
(Table Page 2 of 2) 


Examples 
<video src="video.rm” region="videoregion”> 

<anchor href="rtsp://realserver.company.com/vid2.rm” coords="20,40,80,120"/> 
</video> 


<video src="video.rm” region="videoregion”> 
<anchor href="http://www.company.com” show="pause” coords="10,30,70,100” 
begin="5s" end="45s"/> 
</video> 
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FILE TYPE REFERENCE 


The following tables provide a quick reference to file types commonly used in 
RealSystem G2 media production. This is not a definitive list of all file types used 
in RealSystem G2, however. Plug-in technology allows RealSystem G2 to stream 
virtually any file type. 


Additional Information 


Refer to http://www.real.com/devzone for information on other 
types of media RealSystem G2 can stream. 


RealSystem G2 Standard Streaming Clip Types 


Extension File Type Reference 

.rm or .ra | RealAudio “Creating RealAudio Clips” on page 44 

rm RealVideo | “Creating RealVideo Clips” on page 57 

a) RealPix streaming image mark-up “Images” on page 12 

-rpa RealPix ad rotation “Displaying Banner Ads” on page 138 

ott RealText streaming text “Text” on page 13 

swf Shockwave Flash file for RealFlash “Producing Animation” on page 63 
RealSystem G2 Information Files 

Extension File Type Reference 


Ram file to launch RealPlayer 


“Creating a Ram File Manually” on page 153 


Ram file for embedded presentations 


-smil, .smi | SMIL file for layout and timing “SMIL General Rules” on page 76 
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Video File Types Encodable as RealVideo 
Extension File Type Reference 


avi Windows standard video 


« 


a - Creating RealVideo Clips” on page 57 
-mov QuickTime movie 


Common Video File Types Streamed by RealSystem G2 


Extension File Type Reference 
.asf Advanced Streaming Format 
avi | Windows standard video ; ; 
; - : “Streaming Other Video Formats” on page 61 
.mov QuickTime movie 
Viv Vivo video 


Audio File Types Encodable as RealAudio 


Extension File Type Reference 

.aif Audio Interchange Format 

au Sun standard audio 

.mMov QuickTime movie “Creating RealAudio Clips” on page 44 
.snd Sound audio 

-wav WAV audio 


Common Audio File Types Streamed by RealSystem G2 


Extension File Type Reference 

.aif Audio Interchange Format 

-au Sun-standard audio “Streaming Other Audio Formats” on page 49 
.wav WAV audio 
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Image Files Types Playable Directly in RealPlayer G2 and RealPix 
Extension File Type Reference 


Jpg JPEG (nonprogressive) 2 


: Images” on page 12 
gif GIF87, GIF89, or animated GIF 
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SMIL LANGUAGE CODES 


As “Setting Language Choices” on page 90 explains, SMIL can list different 


language choices that RealPlayer chooses from based on its language preference. 


The following table lists the codes you can use in a SMIL file to indicate clips 


created for specific languages. 


Code Language 

af Afrikaans 

sq Albanian : 
ar-iq Arabic ( Iraq) 


ar-dz Arabic (Algeria) 
ar-bh Arabic (Bahrain) 
ar-eg Arabic (Egypt) 


ar-jo Arabic (Jordan) 
ar-kw Arabic (Kuwait) 
ar-lb Arabic (Lebanon) 
ar-ly Arabic (Libya) 
ar-ma Arabic (Morocco) 
ar-om Arabic (Oman) 
ar-qa Arabic (Qatar) 
ar-sa Arabic (Saudi Arabia) 
ar-sy Arabic (Syria) 
ar-tn Arabic (Tunisia) 
ar-ae | Arabic (U.A.E.) 
ar-ye Arabic (Yemen) 
eu Basque 

bg Bulgarian 

ca Catalan 


Code Language 
zh-hk Chinese (Hong Kong) 
zh-cn | Chinese (People’s Republic) 


zh-sg 


Chinese (Singapore) 


Chinese (Taiwan) 


Croatian 


Czech 
da | Danish 
nl Dutch (Standard) 
nl-be Dutch (Belgian) 
en English 
en-au English (Australian) 
en-bz English (Belize) 
en-gb English (British) 
en-ca English (Canadian) 
en English (Caribbean) 
en-ie English (Ireland) 
en-jm English (Jamaica) 
en-nz English (New Zealand) 
en-za | English (South Africa) 
en-tt English (Trinidad) 
en-us English (United States) 
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Code Language 
et Estonian 
fo Faeroese 
fi Finnish 
fr-be 1 French (Belgian) 
fr-ca French (Canadian) 
fr-lu French (Luxembourg) 
fr | French (Standard) 
fr-ch French (Swiss) 
de-at | German (Austrian) 
de-li German (Liechtenstein) 
de-lu ] German (Luxembourg) 
de German (Standard) 
de-ch German (Swiss) 
“el Greek 
he Hebrew 7 
hu Hungarian 
is Icelandic 
in | Indonesian 
it Italian (Standard) 
it-ch Italian (Swiss) 
ja Japanese 
ko Korean 
ko Korean (Johab) 
lv Latvian 
It | Lichuanian 
no Norwegian 
pl Polish 
pt-br Portuguese (Brazilian) 
pt Portuguese (Standard) 
ro Romanian 
sr Serbian 
sk | Slovak 


Code Language 

sl Slovenian 

es-ar Spanish (Argentina) 
es-bo Spanish (Bolivia) 
es-cl Spanish (Chile) 

es-co Spanish (Colombia) 
es-cr Spanish (Costa Rica) 
es-do Spanish (Dominican Republic) 
es-eCc Spanish (Ecuador) 
eS-SV Spanish (El Salvador) 
es-gt Spanish (Guatemala) 
es-hn Spanish (Honduras) 


es-mx Spanish (Mexican) 


es-ni Spanish (Nicaragua) 
es-pa Spanish (Panama) 
es-py Spanish (Paraguay) 
es-pe Spanish (Peru) 


Spanish (Puerto Rico) 


es Spanish (Spain) 
es-uy Spanish (Uruguay) 
es-ve Spanish (Venezuela) 
SV Swedish 

sv-fi [Swedish (Finland) 
th Thai 

tr Turkish 

uk Ukrainian 

vi Vietnamese 
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Advertising Application 
A RealSystem option that inserts ads 
into SMIL-based presentations. The 
SMIL files use <RealAdInsert/> tags to 
indicate ad placement. 


bandwidth 
The upper limit on the amount of 
data, typically expressed as Kilobits 
per second (Kbps), that can pass 
through a network connection. 

bit 
The smallest unit of measure of data 
in a computer. A bit has a binary 
value, either 0 or 1. 


bit rate 
A measure of bandwidth, expressed as 
the number of bits transmitted per 
second. A 28.8 Kbps modem, for 
example, can transmit or receive 
around 29,000 bits per second. 
broadcast 
To deliver a presentation, whether live 
or prerecorded, in which all viewers 
join the presentation in progress. 
buffering 
Receiving and storing data before 
playing it back. The initial buffering 
time is called preroll. After preroll, 


excessive buffering may stall the 
presentation. 

byte 
A common measurement of data. 
One byte comprises eight (8) bits. 


client 
A software application that receives 


data from a server. A Web browser is a 
client of a Web server. RealPlayer G2 
is a client of RealServer G2. 

clip 
A media file within a presentation. 
Clips typically have an internal 
timeline, as with RealAudio and 
RealVideo. 


codec 
Coder/decoder. Codecs convert data 
between uncompressed and 
compressed formats, reducing the 
bandwidth a clip consumes. 


download 
To send a file over a network with a 
nonstreaming protocol such as 
HTTP. Contrast to stream. 


encoding 
Converting a file into a compressed, 


streaming format. For example, you 
can encode WAV files as RealAudio. 
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Flash 
A Macromedia tool for creating 
animations that can be streamed as 
RealFlash. See also Shockwave Flash. 


HTTP 
The protocol used by Web servers to 
communicate with Web browsers. 
RealServer can use HTTP, but it 
streams clips to RealPlayer G2 with 
RTSP. 


ISP 
Internet Service Provider. A company 
that provides access to the Internet. 
Many ISPs have RealServer available 
to stream media clips. 


Kilobit 
A common unit of data measurement 
equal to 1024 bits. A Kilobit is usually 
referred to in the context of bit rate 
per unit of time, such as Kilobits per 
second (Kbps). 

Kilobyte 
Acommon unit of data measurement 
equal to 1024 bytes. Also equal to 8 
Kilobits. 


PNA 
A proprietary protocol RealServer G2 
supports for backwards compatibility 
with RealSystem 3.0 through S.0. 
URLs using PNA start with pnm://. 
port 
A connection to a server designated 
by anumber such as 8080. RealServer 


G2 uses different ports for the RTSP, 
HTTP, and PNA protocols. 


preroll 
Buffering that occurs at the start of a 
presentation. Preroll should be 15 
seconds or less. 


presentation 
A group of clips coordinated through 
SMIL and streamed from RealServer 
to RealPlayer. 


RDP 
The proprietary data package 
protocol RealServer G2 uses (along 
with RTSP) when communicating 
with RealPlayer G2. Contrast to RTP. 


RealAudio 
A RealSystem clip type for streaming 
audio over a network. RealAudio clips 
use the .rm or .ra extension. 


RealFlash 
A RealSystem clip type for streaming 


Shockwave Flash animation along 
with a RealAudio soundtrack. 


RealPix 
A RealSystem clip type (file extension 
.rp) for streaming still images over a 
network. It uses a mark-up language 
for creating special effects such as 
fades and zooms. 

RealPlayer 
RealNetworks client designed to play 
multimedia presentations streamed 
by RealServer or a Web server. 
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RealServer 
RealNetworks server software used to 


stream multimedia presentations to 
RealPlayer. 


RealSystem 
The system for streaming clips such 


as RealAudio and RealVideo over a 
network. It consists of RealServer, 
RealPlayer, and production tools. 


RealText 
A RealSystem clip type (file extension 
.'t) for streaming text over a network. 
It uses a mark-up language for 
formatting text. 


real-time 
Delivered as it occurs. For example, a 
live broadcast is streamed across a 
network in real-time. 


RealVideo 
A RealSystem clip type for streaming 
video over a network. RealVideo clips 
use the .rm extension. 


rotating banner ads 
Banner advertisments that change at 


a specified interval, such as a new ad 
banner every 30 seconds. 


RTP 
The open, standards-based data 
package protocol RealServer G2 uses 
(along with RTSP) to communicate 
with RTP-based clients. Contrast to 
RDP. 


RTSP 
The open, standards-based control 
protocol RealServer G2 uses to 
stream clips to RealPlayer G2 or any 
RTP-based client. Contrast to HTTP. 


server 
1. A software application, such as a 
Web server or RealServer G2, that 
sends clips over a network. 


2. A computer that runs server 
software. 


Shockwave Flash 
A compressed Flash file format (file 


extension .swf) used as the animation 
component in RealFlash. 


SMIL 
Synchronized Multimedia 


Integration Language. A mark-up 
language for specifying how and 
when each clip plays. SMIL files use 
the extension .smil or .smi. 


stream 
v. To send a media clip over a network 


so that it begins playing back as 
quickly as possible. 

n. A flow of a single type of data, 
measured in Kilobits per second 
(Kbps). A RealVideo clip’s soundtrack 
is one stream, for example. 


SureStream 
A technology that allows switching to 
a lower-bandwidth encoding in a 
RealAudio or RealVideo clip to 
compensate for network congestion. 
Available only in RealSystem G2. 


URL 
Uniform Resource Locator. A 


location description that lets a Web 
browser or RealPlayer receive a clip 
stored on a Web server or RealServer. 
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A ActiveX control 

aspect ratio, 130 

automatic playback, 131 

background color, 129 

basics of using, 119 

centering clip, 130 

class ID, 119 

consoles, 127 

image window, 122 

laying out presentations, 132 

logo suppression, 131 

looping playback 
indefinitely, 132 
set number of times, 132 

object ID, 119 

parameter list, 135 

parameters 
AUTOSTART, 131 
BACKGROUNDCOLOR, 129 
CENTER, 130 
CONSOLE, 127 
CONTROLS, 121 
HEIGHT, 120 
LOOP, 132 
MAINTAINASPECT, 130 
NOJAVA, 121 
NOLABELS, 130 
NOLOGO, 131 
NUMLOOP, 132 
REGION, 133 
SHUFFLE, 132 
SRC, 119 
WIDTH, 120 

RealPlayer controls, 121 
multiple, 127 

shuffling playback, 132 

size parameters, 120 


percentages, 121 
source parameter, 119 
specifying in links, 146 
supported applications, 117 
title suppression, 130 
URL handling, 121 
using in Web page, 119 
VBScript extensions, 118 
Ad insertion 
ad formats, 137 
banner ads 
duration, 140 
for broadcasts, 140 
layout, 138 
overview, 138 
properties, 140 
sizes, 138 
overview, 137 
<RealAdInserv> tag, 141 
rich media ads 
commercial breaks, 143 
interstial ads, 143 
lead-in video ad, 141 
overview, 141 
playlist disabling, 142 
region layout, 142 
SMIL files for 
automatic generation, 138 
manual creation, 137 
Advertising 
on RealGuide, 157 
see also Ad insertion 
AIFF 
converting to RealAudio, 44 
streaming, 49 
Animation, see RealFlash 
ASF streaming, 61 
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AU Banner ads, see Ad insertion 
converting to RealAudio, 44 Bit rate, see Bandwidth 
streaming, 49 Broadcasting 

Audio archiving, 163 
cables, 41 banner ad durations, 140 
DC offset, 43 broadcast quality, 163 
digitizing, 43 CPU requirements, 163 
dynamics compression, 44 introduction, 159 
frequency equalization, 44 live vs. prerecorded, 159 
input levels, 42 preparation, 162 
normalization, 43 RealGuide listings, 157 
recording tips, 41 RealText, 160 
source media, 41 RGB and YUV, 160 
streaming SMIL files, 164 

formats for, 12 stream synchronization, 165 
steps for, 39 tools, 160 
see also RealAudio trial run, 163 

Authoring Kit, 4 

AVI C Captions for the hearing impaired, 178 
converting to RealVideo, 57 Codecs 
streaming, 61 see Bandwidth 

see RealVideo 
B Backwards compatibility see RealAudio 
overview, 8 Compression 
RealPlayer clip support, 13 audio dynamics, 44 
single URLs for, 8 overview, 15 
through Ram file, 155 RealAudio, 44 
through Ramgen, 149 RealVideo, 57 

Bandwidth CPU guidelines, 156 
available for presentations, 29 
common connection speeds, 29 D Downloading 
dividing between clips, 30 RealPlayer plug-ins, 24 
multimedia clips, 33 versus streaming, 21 
negotiation, 35 
eueraain, 27 E EMBED tag, see Netscape plug-in 


RealFlash, 64 

RealMedia characteristics, 30 
single media clip, 32 

SMIL choice settings, 90 
SureStream clips 


Embedded presentations 
see ActiveX control 
see Netscape plug-in 
Encoding tools 


in SMIL file, 176 catia 160 
overview, 34 ENAMIEW 
RealAudio, 49 sed Tae Bs 
RealVideo, 59 ealVideo, 
targets, 29 Extension list, 191 
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F File extension list, 191 
Flash, see RealFlash 


G GIFs, see Images 
Graphics, see Images 


H HTML, see Web page 

HTTP 
compared to RTSP, 21 
in presentation links, 145 
in SMIL file, 80 
in Web page links, 146 
see also Web server 

Hypertext, see Links 


I Images 
bandwidth use, 112 
GIF background color, 113 
links to Web pages, 113 
RealPlayer control, 114 
reliable transmission, 115 
supported formats, 12 
see also RealPix 


J JPEGs, see Images 


L _ Language choices 
codes, 195 
setting, 90 
Laying out presentations 
with ActiveX control, 132 
with HTML, 133 
with Netscape plug-in, 132 
with SMIL 
in RealPlayer, 95 
in Web page, 132 
Links 
in image tags, 113 
quick reference, 170 
Ram file 
to local files, 154 
to RealServer, 154 
to Web server, 154 
SMIL file 


to local files, 80 
to RealServer, 78 
to Web server, 80 


Web page 


to RealServer, 146 
to Web Server, 149 


Live broadcast, see Broadcasting 


Metafile, see Ramgen 
MIME types in Web server, 153 
MPEG 
converting to RealAudio, 45 
converting to RealVideo, 57 


Netscape plug-in 
aspect ratio, 130 
automatic playback, 131 
background color, 129 
basics of using, 118 
centering clip, 130 
consoles, 127 
image window, 122 
JavaScript extensions, 118 
laying out presentations, 132 
local file links, 120 
logo suppression, 131 
looping playback 


indefinitely, 132 
set number of times, 132 


nonembedded links, 118 
parameter list, 135 
parameters 


AUTOSTART, 131 
BACKGROUNDCOLOR, 129 
CENTER, 130 
CONSOLE, 127 
CONTROLS, 121 
HEIGHT, 120 

LOOP, 132 
MAINTAINASPECT, 130 
NOJAVA, 121 
NOLABELS, 130 
NOLOGO, 131 
NUMLOOP, 132 
REGION, 133 
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Password authentication, 23 
Pay-per-view, 23 
Plug-ins 
see Netscape plug-in 
see RealPlayer 
PNA, 8 
Preroll 
masking, 173 
overview, 28 
Protocols 
PNA, 8 
RDP, 8 
RTP, 8 
RTSP, 21 
Publishing tools, see Encoding tools 


QuickTime 
converting to RealAudio, 45 
converting to RealVideo, 57 
streaming, 61 


.ram extension, 148 

Ram file 
comments, 155 
creating manually, 153 
definition, 22 
linking 
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SHUFFLE, 132 to local files, 154 
SRC, 119 to RealServer, 154 
WIDTH, 120 to Web server, 154 

RealPlayer controls, 121 replacing with Ramgen, 148 
multiple, 127 see also Ramgen 

shuffling playback, 132 Ramgen 

size parameters, 120 options 
percentages, 121 altplay, 149 

source parameter, 119 combining, 149 

specifying in links, 146 embed, 148 

supported browsers, 117 using, 148 

title suppression, 130 RDP, 8 

URL handling, 121 Real Broadcast Network (RBN), 161 

using in Web page, 117 RealAudio 

bandwidth characteristics, 30 
O- OBJECT tag, see ActiveX control batch encoding, 49 


codecs 
broadcasting with, 162 
list of, 45 
lossy nature, 45 
multiple streams, 6 
using, 45 
encoding tips, 48 
exporting from Flash, 72 
input formats, 44 
sampling rates, 45 
SureStream 
backwards compatibility, 49 
broadcasting, 162 
codecs for, 45 
Web server playback, 151 
see also Audio 
RealFlash 
audio 
export, 72 
import, 64 
bandwidth 
gauging from file size, 71 
targeting, 64 
benefits of, 63 
Flash 3.0 features, 64 
frame rate, 69 
interactive commands, 70 
minimizing 
CPU usage, 69 
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file size, 68 
overview, 63 
production tips, 67 
Ram files, 73 
RealPlayer 5.0 support, 73 
Shockwave export, 71 
SMIL mark-up, 73 
spreadsheet, 72 
stream synchronization, 64 
symbols, 69 
tools, 63 
tuning, 72 
tweening, 70 
Web server delivery, 151 
RealGuide, 157 
RealPix 
bandwidth characteristics, 31 
description, 12 
Web server delivery, 151 
RealPlayer 
captions preference, 178 
clip compatibility, 13 
control through image links, 114 
download logo, 23 
embedding in Web page 
see ActiveX control 
see Netscape plug-in 
language choices 
codes, 195 
setting, 90 
multiple audio streams, 6 
playlists 
disabling for ads, 142 
managing through SMIL, 92 
plug-in download, 24 
RealFlash interactivity, 70 
RealServer 
broadcasting, 161 
placing files on, 146 
RealSystem 
animation, see RealFlash 
architecture, 5 
media formats 
audio, 12 
image, 12 


Index 


new, 13 
text, 13 
video, 12 
overview, 21 
presentation testing, 156 
RealText 
bandwidth characteristics, 31 
broadcasting, 160 
captions, 178 
description, 13 
Web server delivery, 151 
RealVideo 
bandwidth characteristics, 30 
codecs 
choosing, 57 
list of, 58 
lossy nature, 57 
cropping, 60 
encoding tips, 58 
input formats, 57 
production, 57 
resizing, 60 
Scalable Video Technology, 60 
SureStream 
broadcasting, 162 
codec, 58 
see also Video 
Regions, see SMIL regions 
Relative links 
in Ram file, 153 
in SMIL, 79 
with Netscape plug-in, 120 
Rich media ads, see Ad insertion 
.rpm extension, 148 
RTP interoperability, 8 
RTSP 
and PNA, 8 
compared to HTTP, 21 
in presentation links, 145 
in SMIL file, 78 
overview, 21 


Shockwave Flash, see RealFlash 


SMIL 
ad insertion with, 137 
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anchors, 107 
bandwidth choices, 90 
broadcasting 
multiclip presentations, 164 
synchronization, 165 
captions 
RealPlayer preference for, 178 
region filler, 179 
resizing for captions off, 180 
with groups, 179 
case sensitivity, 76 
clip information, 92 
clip type indicators, 77 
closing tag, 76 
coded characters, 94 
comments in, 77 
features, 18 
file location syntax 
for local machine, 80 
for RealServer, 78 
for Web server, 80 
relative links, 79 
general rules, 76 
header 
coded characters, 94 
defining, 76 
hyperlinks, see SMIL links 
image commands 
bandwidth, 112 
GIF background, 113 
RealPlayer control, 114 
reliable transmission, 115 
language choices 
codes, 195 
setting, 90 
layout, see SMIL regions 
links 
anchors, 107 
clip 
to clip, 105 
to SMIL file, 109 
hot spots, 106 
spatial coordinates, 107 
temporal coordinates, 109 
timeline offsets, 111 
to Web pages, 106 


see also SMIL, file location syntax 
multifile playback, 153 
normal play time format, 85 
parallel tag, 81 

end values, 82 

repeating, 82 

with sequence tag, 83 
presentation information, 91 
quotation marks for values, 76 
RealFlash presentations, 73 
RealPlayer control, 114 
regions 

assigning to clips, 103 

background, 96 

colors, 99 

defining, 96 

hiding, 174 

media fit attributes, 100 

overlapping, 101 

percentage values, 98 

root-layout, 96 

transparency, 99 
repeating clips, 82 
sequence tag, 81 

repeating, 82 

with parallel tag, 83 
.smi extension, 77 
.smil extension, 77 
source tags, 77 

repeating, 82 
SureStream clips, 176 
switch tag, 89 
timing elements, 84 

begin, 85 

clip begin and end, 86 

with Web server delivery, 152 

duration, 87 

fill values, 88 
tips on using, 173 
title, author, copyright, 91 
Web server playback, 152 
z-index, 101 


SND conversion to RealAudio, 45 
Streaming 


versus downloading, 21 
Web server, 149 
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see also RealSystem 
SureStream 

backwards compatibility, 49 

broadcasting, 162 

overview, 35 

RealAudio codecs, 45 

RealVideo codec, 58 

with SMIL, 176 


Technical support, 4 
Testing presentations, 156 
Timecast, see RealGuide 
Timing a presentation 
timeline synchronization, 16 
with SMIL, 81 


URLs, see links 


Video 
formats for streaming, 12 
lighting, 54 
movement, 53 
recording tips, 53 
source formats, 53 
streaming 
formats for, 61 
steps for, 51 
S-video, 55 
see also RealVideo 
Vivo streaming, 61 


Wallclocks for broadcasts, 165 
WAV 
converting to RealAudio, 45 
streaming, 49 
Web page 
linking presentation to, 146 
playback in, 117 
Web server 


MIME type configuration, 153 


playback 
instructions, 149 
limitations, 151 
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